架構
啟動流程
mermaid
flowchart TD
A[main.go] --> B{設定來源}
B -->|Base64| C[config bytes]
B -->|stdin| C
B -->|file| D[config file]
C --> E[config.Parse]
D --> E
E --> F[hub.ApplyConfig]
F --> G[executor.ApplyConfig]
G --> H[Controller routes]main.go：
- 解析 flags/env。
- 處理
convert-ruleset、generate、age子命令。 - 設定 home、geodata、age keys。
- 取得 config bytes 或 file。
-t時只 parse。- 一般模式呼叫
hub.Parse。 - 註冊 updater、post-up/down、signals。
Apply config
hub/executor 的主要順序：
- Lock config apply。
- 暫停 tunnel。
- 更新 CA、experimental、auth users。
- 更新 proxies/providers。
- 更新 rules、sniffer、hosts。
- 更新 general、NTP、DNS。
- Stage Aster managed listeners。
- Patch listeners。
- Configure Aster。
- 更新 TUN、iptables、tunnels。
- 載入 providers/profile/updater。
- Reset resolver connections。
- 恢復 running。
這不是完整 ACID transaction。部分 subsystem 已更新後仍可能遇到後續錯誤；Aster listener 路徑另採 fail-closed。
Data plane
mermaid
flowchart LR
A[Listener] --> B[ConnContext / PacketAdapter]
B --> C[Tunnel]
C --> D[Metadata normalization]
D --> E[Fake-IP / Hosts]
E --> F[Sniffer]
F --> G[Process lookup]
G --> H[Rule match]
H --> I[Proxy group]
I --> J[Outbound adapter]
J --> K[Transport]TCP 會建立 connection tracker；UDP 依 key hash 分配到 worker queue。Queue 滿時 UDP packet 可能被 drop，因此高流量環境需實測容量與延遲。
Package map
| 路徑 | 責任 |
|---|---|
adapter/inbound | 入站 connection/packet metadata adapters |
adapter/outbound | Proxy outbound implementations |
adapter/outboundgroup | Select、URL test、fallback、load balance |
adapter/provider | Proxy providers 與 health checks |
common | Generic collections、pool、network wrappers、sync |
component | CA、dialer、resolver、geodata、sniffer、profile、updater |
component/aster | Aster manager、users、traffic、store、subscriptions |
config | YAML decode、defaults、validation |
constant | Interfaces、metadata、paths、features |
dns | DNS clients、server、policy、fake-IP integration |
hub | Apply config 與 Controller |
listener | General 與 named inbound servers |
rules | Rule parsing/matching/providers |
transport | Protocol/crypto/mux/obfuscation |
tunnel | Central TCP/UDP routing data plane |
Aster control plane
mermaid
flowchart TD
API[Admin API] --> M[Manager]
M --> S[Store]
M --> R[Runtime indexes]
M --> L[Managed Listener]
T[Traffic Tracker] --> M
M --> U[Subscription Builder]Manager 內同時維護：
- Locked mutable store。
- Atomic immutable runtime indexes。
- Managed listener set。
- Subscription token index。
- Traffic accumulator。
讀取 hot path 優先使用 atomic runtime snapshot，mutation 才進入 manager lock 與 store commit。
Controller route groups
Router 先掛載：
- Aster subscription。
- 符合 policy 時的 Aster admin。
再建立一般 Controller auth group：
/configs/proxies/rules/connections/providers/cache/dns/storage/restart/upgrade
最後掛載 /ui 與 optional DoH。因此三種 route 的 authentication boundary 不完全相同。
Platform abstraction
Go build constraints 分隔：
- Listener/socket APIs。
- TUN。
- Process lookup。
- Memory statistics。
- Store lock/replace/security。
- Power events。
- Routing mark/reuse。
修改平台檔案時，至少要確保 Linux、Windows、macOS build。CI 的 macOS root tests 會排除部分 inbound tests，不能只靠單一 CI job 推論所有平台 runtime 行為。
Shutdown
正常 shutdown：
- 暫停 tunnel。
- Flush Aster traffic。
- 關閉 listeners/TUN。
- 清理自動 iptables。
- 關閉 providers與 background services。
- 保存 fake-IP/cache。
Hard kill 無法保證最後一次 flush；部署應使用 SIGTERM 並給足 termination grace period。