Skip to content

docs: installing on Alpine, one-port devices, uninstall (#3) - #92

Merged
Cd1s merged 1 commit into
mainfrom
docs/install-alpine
Sep 26, 2026
Merged

Cd1s merged 1 commit into
mainfrom
docs/install-alpine

Conversation

@Cd1s

@Cd1s Cd1s commented Sep 26, 2026

Copy link
Copy Markdown
Owner

What

New guide docs/install-alpine.md (Chinese, with an English summary):

  • which Alpine image to use, and setup-alpine in disk mode sys (diskless mode needs lbu commit for every change under /etc);
  • identifying ports with ip -br link and carrier, and what a main router needs;
  • one port only: run as a side router (mode: bypass, mode: bypass (side router) and ap (pure AP) (#24, #26) #85), or as a one-armed router with a VLAN-capable switch (WAN on a tagged VLAN of the LAN port);
  • verifying with mr status, mr doctor and the web UI;
  • rolling back with mr history / mr rollback;
  • uninstalling, which also restores the networking service that the installer disables and the /etc/network/interfaces it renames.

Other changes:

  • install.sh: with one port and no radio it explains the options and suggests bypass.
  • README: links the guide, mentions the mode question, and no longer says the side-router mode is in development.

Verification

  • The one-armed config validates and renders eth0.10 (WAN) + eth0 in br-lan.
  • install.sh passes shellcheck (sh tools/ci.sh: ALL CHECKS PASSED).

Closes #3

https://claude.ai/code/session_01HWeUjo1dmS7gBkCYHrVjCr

…erify, roll back, uninstall

- Alpine image and `setup-alpine` in disk mode `sys`; identifying ports; what a main router needs.
- One port: side router (mode bypass) or a one-armed router with a VLAN switch.
- Verify, roll back, uninstall (restores Alpine's networking).
- install.sh suggests mode bypass when it finds one port and no radio; README points to the guide and
  no longer says the side-router mode is in development.

Closes #3

Claude-Session: https://claude.ai/code/session_01HWeUjo1dmS7gBkCYHrVjCr
@Cd1s
Cd1s merged commit e69f2ed into main Sep 26, 2026
2 checks passed
@Cd1s
Cd1s deleted the docs/install-alpine branch September 26, 2026 04:45
@Cd1s Cd1s mentioned this pull request Sep 26, 2026
52 tasks done
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.

文档:Alpine 安装步骤、网口要求与单网口设备

1 participant