|
| 1 | +````markdown |
| 2 | +# Release Notes - v0.3.0 |
| 3 | + |
| 4 | +**Release Date:** February 1, 2026 |
| 5 | + |
| 6 | +## 🚀 Highlights |
| 7 | + |
| 8 | +This release focuses on stronger observability and more robust proxy management: |
| 9 | +- Live log streaming in the Web UI |
| 10 | +- Custom CA certificate uploads for TLS-verified upstreams |
| 11 | +- More consistent and stable Caddy proxy configuration handling |
| 12 | + |
| 13 | +## ✨ Key Features |
| 14 | + |
| 15 | +### Web UI Logging (Live Streaming) |
| 16 | +- Comprehensive logging system added to the Web UI |
| 17 | +- Live streaming of logs to the browser for faster troubleshooting |
| 18 | +- Improved visibility into proxy, relay, and service activity |
| 19 | + |
| 20 | +### Custom CA Certificate Uploads |
| 21 | +- Upload custom CA certificates for upstream TLS verification |
| 22 | +- Enables secure connections to services using internal or private PKI |
| 23 | +- Reduces the need for insecure TLS bypasses |
| 24 | + |
| 25 | +### Proxy Management Improvements |
| 26 | +- Aligned Caddy route structure for consistent configuration output |
| 27 | +- Persisted server mappings per proxy to minimize churn |
| 28 | +- Refactored proxy manager for clearer configuration handling |
| 29 | + |
| 30 | +## 🔧 Technical Changes |
| 31 | + |
| 32 | +### Added |
| 33 | +- Logging subsystem with live-streaming endpoints in the Web UI |
| 34 | +- Custom CA certificate upload pipeline for proxy TLS |
| 35 | +- Local Web UI development workflow for rapid iteration |
| 36 | + |
| 37 | +### Changed |
| 38 | +- Caddy route generation to maintain consistent proxy structure |
| 39 | +- Caddy server mappings stored per proxy for stability |
| 40 | +- Internal proxy manager refactors to match new configuration flows |
| 41 | + |
| 42 | +### Removed |
| 43 | +- Legacy file-based proxy handling (Caddyfile/JSON-based proxy CRUD) |
| 44 | + |
| 45 | +## 📦 Upgrade Instructions |
| 46 | + |
| 47 | +### Docker Users |
| 48 | + |
| 49 | +```bash |
| 50 | +# Pull the latest image |
| 51 | +docker pull sudocarlos/tailrelay:v0.3.0 |
| 52 | +# or |
| 53 | +docker pull sudocarlos/tailrelay:latest |
| 54 | + |
| 55 | +# Restart your container |
| 56 | +docker restart tailrelay |
| 57 | +``` |
| 58 | + |
| 59 | +### Start9 Users |
| 60 | + |
| 61 | +1. Stop the current container: |
| 62 | + ```bash |
| 63 | + sudo podman stop start9.tailscale |
| 64 | + sudo podman rm start9.tailscale |
| 65 | + ``` |
| 66 | +2. Pull the new version: |
| 67 | + ```bash |
| 68 | + sudo podman pull docker.io/sudocarlos/tailrelay:v0.3.0 |
| 69 | + ``` |
| 70 | +3. Start with the same configuration: |
| 71 | + ```bash |
| 72 | + sudo podman run --name start9.tailscale \ |
| 73 | + -v /home/start9/tailscale/:/var/lib/tailscale \ |
| 74 | + -e TS_HOSTNAME=start9 \ |
| 75 | + -p 8021:8021 \ |
| 76 | + --net start9 \ |
| 77 | + docker.io/sudocarlos/tailrelay:v0.3.0 |
| 78 | + ``` |
| 79 | + |
| 80 | +## 🔍 Verification |
| 81 | + |
| 82 | +After upgrading, verify the new features: |
| 83 | + |
| 84 | +```bash |
| 85 | +# Web UI health (should load and show logs) |
| 86 | +curl http://localhost:8021 |
| 87 | + |
| 88 | +# Caddy config routes |
| 89 | +tailrelay_caddy_routes=$(curl -s http://localhost:2019/config/apps/http/servers/tailrelay/routes) |
| 90 | +echo "$tailrelay_caddy_routes" | jq |
| 91 | +``` |
| 92 | + |
| 93 | +## ⚠️ Notes |
| 94 | + |
| 95 | +- Proxy configuration is now fully API-driven; legacy file-based proxy handling has been removed. |
| 96 | +- If you use a private CA for upstream TLS, upload it through the Web UI before enabling verification. |
| 97 | + |
| 98 | +## 📝 Changelog |
| 99 | + |
| 100 | +### Added |
| 101 | +- Live log streaming in the Web UI |
| 102 | +- Custom CA certificate upload support for upstream TLS verification |
| 103 | +- Local Web UI development workflow |
| 104 | + |
| 105 | +### Changed |
| 106 | +- Consistent Caddy proxy route structure |
| 107 | +- Persisted Caddy server mappings per proxy |
| 108 | +- Refactored proxy manager and configuration handling |
| 109 | + |
| 110 | +### Removed |
| 111 | +- Legacy proxy file handling |
| 112 | + |
| 113 | +--- |
| 114 | + |
| 115 | +**Full Changelog**: https://github.com/sudocarlos/tailscale-socaddy-proxy/compare/v0.2.1...v0.3.0 |
| 116 | +```` |
0 commit comments