Rework Caddy guide: dual transports, IP certs, beginner-friendly flow - #11
Open
angelodlfrtr wants to merge 1 commit into
Open
Rework Caddy guide: dual transports, IP certs, beginner-friendly flow#11angelodlfrtr wants to merge 1 commit into
angelodlfrtr wants to merge 1 commit into
Conversation
angelodlfrtr
force-pushed
the
docs/ws-tutorial
branch
from
September 4, 2026 14:26
4649c07 to
ae491e8
Compare
angelodlfrtr
marked this pull request as ready for review
September 4, 2026 14:29
Greptile SummaryThe PR replaces the former Caddy overview with an end-to-end deployment tutorial for direct Shadowsocks and Shadowsocks-over-WebSockets, supporting either domain or IP certificates.
Confidence Score: 5/5The PR appears safe to merge; the latest changes fully address both previous findings without introducing a new actionable defect. The OpenSSL dependency is now installed for every documented distribution family, and both credential-bearing files are assigned mode
|
| Filename | Overview |
|---|---|
| docs/vpn/advanced/caddy.mdx | Replaces the previous overview with a complete dual-transport Caddy deployment guide and now securely creates credential-bearing configuration files with all required dependencies. |
| scripts/verify_translations.py | Marks the rewritten Caddy guide as English-only so removal of stale locale copies does not fail translation verification. |
Flowchart
%%{init: {'theme': 'neutral'}}%%
flowchart LR
Client[Outline Client] --> Choice{Selected access key}
Choice -->|Direct TCP and UDP| Direct[Caddy layer4 listener]
Choice -->|WSS over TLS| HTTPS[Caddy HTTPS listener]
HTTPS --> WS[WebSocket stream or packet handler]
Direct --> Outline[Shared Outline Shadowsocks handler]
WS --> Outline
Outline --> Internet[Internet]
Reviews (2): Last reviewed commit: "Rework Caddy guide: dual transports, IP ..." | Re-trigger Greptile
Replace the "HTTPS with Caddy" page with a full deployment tutorial (now caddy.mdx) built on the outlinecaddy module from tunnel-server: - Serve direct Shadowsocks TCP/UDP and Shadowsocks-over-WebSockets from one Caddy config with shared access keys - Support Let's Encrypt IP certificates (shortlived ACME profile) as an alternative to domain certificates, via tabbed setup options - Build with the bundled cmd/caddy main package (go install) instead of xcaddy, which is kept as a collapsed alternative - Generate secrets into ~/outline.env so configs and access keys are produced by copy-paste heredocs with no manual placeholder editing - Add firewall commands (ufw/firewalld), per-step checkpoints with expected output, a troubleshooting section, and an architecture SVG - Run Caddy as a systemd service under a dedicated user - Drop the stale caddy.md translations so locales fall back to the up-to-date English page Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
angelodlfrtr
force-pushed
the
docs/ws-tutorial
branch
from
September 4, 2026 14:40
ae491e8 to
ac76226
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Replace the "HTTPS with Caddy" page with a full deployment tutorial (now caddy.mdx) built on the outlinecaddy module from tunnel-server: