EasyTier NAS Docker 部署笔记
EasyTier NAS Docker 部署笔记（TNAS）
-
日期：2026-09-22
-
目标主机：
192.168.1.196:9222（TerraMaster TNAS-0976） -
同机部署：[[2026-09-22-Penpot-Docker部署笔记]]
1. 环境信息
| 项目 | 值 |
|---|---|
| 主机 | TNAS-0976（Tnas 2018.04.9） |
| SSH | 端口 9222，用户 ZcAuto_1234 |
| Docker | 20.10.17（DockerEngine 套件） |
| docker CLI | /Volume1/@apps/DockerEngine/dockerd/bin/docker（PATH 中无 docker） |
| 镜像 | easytier/easytier:latest（2.6.4-8428a89d） |
登录与镜像加速等基础环境见 [[2026-09-22-Penpot-Docker部署笔记]]，不重复。
2. 网络参数
| 项目 | 值 |
|---|---|
| 网络名称 | ZcAuto_Nas |
| 网络密码 | 与网络名称相同（明文入 KeePass，笔记不存） |
| 入口节点 | tcp://jianstudio.cn:11010、udp://jianstudio.cn:11010 |
| 虚拟 IP | DHCP 自动分配（重启会变；以 easytier-cli peer 的 Local 行为准，勿写死） |
| 子网代理 | -n 192.168.1.0/24（异地可直接访问局域网 IP，含 Penpot） |
3. 部署命令
镜像 Entrypoint 为 ["/sbin/tini","--","easytier-core"]，直接跟参数即可：
PATH
docker
docker
--name
--hostname
--restart
--privileged
--network
-e
easytier/easytier:latest
-d
--network-name
--network-secret
-p
-p
-n
要点：
-
--privileged --network host：需 tun 设备与全协议监听（官方 Docker 部署标准姿势） -
-d：DHCP 自动分配虚拟 IP -
--restart unless-stopped：开机自启 -
-n 192.168.1.0/24：子网代理，把局域网段共享给组网节点；Penpot 等服务异地统一走http://192.168.1.196:<port>访问（与PENPOT_PUBLIC_URI一致，避免黑屏）
4. 部署结果（验证）
docker ps：容器 easytier Up，镜像 easytier/easytier:latest。
日志关键行：
new peer connection ... tunnel_type: "tcp" ... jianstudio.cn:11010
new peer connection ... tunnel_type: "udp" ... jianstudio.cn:11010
tun device ready dev="tun0"
dhcp ip changed old=None new=Some(10.126.126.x/24)
easytier-cli peer（示例；Local 行 ipv4 即本节点虚拟 IP）：
| ipv4 | hostname | cost | lat(ms) | tunnel | version |
|---|---|---|---|---|---|
| 10.126.126.x/24 | easytier-nas | Local | - | - | 2.6.4-8428a89d |
| — | PublicServer_jianstudio-vps | p2p | ~15 | udp,tcp | 2.6.4-8428a89d |
| 10.126.126.2/24 | JianPC | p2p | ~25 | udp,tcp | 2.6.4-8428a89d |
easytier-cli route 应看到本节点 proxy_cidrs = 192.168.1.0/24，表示子网代理已生效：
docker
easytier-cli node：查看 Peer ID / NAT 类型 / 公网 IP。
5. 常用运维命令
export
docker
docker
docker
docker
# 升级
docker
docker
# 重新执行第 3 节 run 命令（同参数）
6. 踩坑记录
-
docker 不在 PATH：用
/Volume1/@apps/DockerEngine/dockerd/bin/docker或先 export PATH（同 Penpot 笔记）。 -
plink
-y不存在：本机 PuTTY 版本无-y；用sshpass+ OpenSSH 或echo y | plink首次缓存 hostkey。 -
镜像 pull 走已有 mirrors：daemon.json 已配 DaoCloud 等加速，直接 pull 成功，无需再改。
-
容器监听 11010–11013（tcp/udp/wg/ws/wss/faketcp/quic）占宿主 host 网络端口；若宿主另有服务用这些端口需错开。
-
虚拟 IP 重启会变：DHCP 分配，
docker rm/重启后 Local IP 可能从.1变成.3等；不要把10.126.126.1当固定地址写进书签或PENPOT_PUBLIC_URI。 -
Penpot 经组网黑屏（2026-09-24）：异地打开
http://10.126.126.1:9001只出静态壳，config.js里penpotPublicURI=http://192.168.1.196:9001回连失败 → 黑屏。修法：Easytier 加-n 192.168.1.0/24子网代理，异地改开http://192.168.1.196:9001（与 PUBLIC_URI 一致）。详见 [[2026-09-22-Penpot-Docker部署笔记]] 第 9 节。
7. 相关
-
[[2026-09-22-Penpot-Docker部署笔记]]（同 TNAS 主机环境；异地访问走本节点子网代理）
-
[[2026-02-25-Easytier远程路由器配置笔记]]（公司定制路由器上的 EasyTier，另一网络）
-
[[06-Wiki/Luckfox-Lyra-PLC-EasyTier升级2.6.4|Luckfox-Lyra-PLC EasyTier 升级 2.6.4]]（同版本 2.6.4，同入口节点 jianstudio.cn）
8. 后续建议
-
子网代理
-n 192.168.1.0/24（2026-09-24 已加，Penpot 异地访问用） -
若只开放个别主机/端口，可把
-n收窄为/32或更小网段 -
密钥/密码入库 KeePass；本笔记不记录明文密码