Skip to content

docs: add home bypass router guide - #15

Merged
easonxiang merged 7 commits into
masterfrom
codex/home-bypass-router-article
Oct 23, 2026
Merged

easonxiang merged 7 commits into
masterfrom
codex/home-bypass-router-article

Conversation

@easonxiang

Copy link
Copy Markdown
Contributor

Summary

  • Add a detailed draft documenting the NAS virtual OpenWrt, sing-box, Hysteria2, DNS, rule updates, verification, and rollback workflow.
  • Add the article cover and network topology illustration.
  • Allow draft posts to appear in development previews while keeping them excluded from production.

Validation

  • Reviewed the article and image references; local preview was visually checked in the prior task.
  • CI will run on this pull request.

@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 23, 2026 •

Copy link
Copy Markdown

Deploying weenas-blog with  Cloudflare Pages  Cloudflare Pages

Latest commit: 66e4917
Status:⚡️  Build in progress...

View logs

Eason and others added 3 commits October 24, 2026 00:22
- IPv6: explain that the kept IPv6 default route lets IPv6 traffic bypass the
  side router, so the setup relies on the side router's DNS returning only
  A records; note that stopping RA/DHCPv6 DNS affects every device
- DNS: separate queries sent to the router itself (dnsmasq, which must
  forward to sing-box) from queries hijacked through TUN
- Single-arm routing: mention asymmetric return paths for traffic outside
  TUN and LAN masquerading
- Update steps: check the candidate config, and skip unchanged rules before
  backing up and restarting
- Failure section: unmatched traffic defaults to the proxy, so a VPS outage
  affects more than the listed proxy sites
- Add an illustrative trimmed sing-box config; rewrite report-style passages
  ("本轮只读检查", "之前特别提到") for readers
- Redraw the topology as a real vector SVG: proxy traffic also leaves via the
  main router, and labels fit their boxes
- postFilter: simplify to DEV || (!draft && published)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@easonxiang
easonxiang force-pushed the codex/home-bypass-router-article branch from 543da95 to 00f18ae Compare October 23, 2026 16:26
Eason and others added 2 commits October 24, 2026 00:31
Checked read-only over SSH on the side router (OpenWrt 25.12.6, sing-box
1.13.21):

- Config example now mirrors the real one: DoH upstreams (Cloudflare via
  proxy, AliDNS direct) with per-rule-set DNS rules, ipv4_only, TUN with
  strict_route and route_exclude_address (LAN ranges excluded there rather
  than via a route rule), port-53 hijack before sniff
- DNS chain as it actually works: dnsmasq (cache 1000) forwards to 1.1.1.1,
  and that query is captured by TUN and hijacked into sing-box DNS
- Masquerading: not enabled; excluded ranges are LAN/reserved plus the VPS
  address, so the asymmetric-routing case doesn't arise here
- Update script steps follow the script: digest check right after compiling,
  candidate check, backup, final-config check, restart with pidof check
- Upstream rules build daily at 23:00 UTC (07:00 Beijing), not 08:00
- logread is a small ring buffer flooded by sing-box info logs, so weekly
  update logs are gone within minutes; suggest warn level or a log file
- Note that the side router must not send RA/DHCPv6

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@easonxiang
easonxiang marked this pull request as ready for review October 23, 2026 16:44
@easonxiang
easonxiang enabled auto-merge (squash) October 23, 2026 16:44
Eason and others added 2 commits October 24, 2026 00:58
CI failed downloading the 43 MB tire GIF from the home photo host: each
attempt hit the 60 s overall timeout while data was still flowing, so all
four retries failed the same way and Astro aborted the build.

Downloads now abort only after 30 s without data (capped at 10 min per
attempt), and still retry on stalls and mid-body disconnects. Size probes
keep the short overall timeout since they read only the header.

Tested against a local server: a 70 s steady download now succeeds, a
stalled one aborts after 30 s per attempt, and cut-off bodies are retried.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The last run was cancelled at the 10-minute limit while still downloading
post images from the home photo host (no errors). The image cache is only
saved after a successful run, so cold runs keep repeating the slow download
until one finishes; Cloudflare Pages (20-minute limit) built the same commit
fine.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@easonxiang
easonxiang merged commit 577d8a8 into master Oct 23, 2026
2 of 3 checks passed
@easonxiang
easonxiang deleted the codex/home-bypass-router-article branch October 23, 2026 17:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant