当前发布边界：本公开仓库只包含文档、部署脚本和发布所需资源；运行时以预编译 Docker 镜像提供。源码、证书、密钥和客户机运行数据不在仓库中。
手机浏览器 → HTTPS/Caddy → 网关 → 4G 模块与实体 SIM
NasAnySim 是一个面向自托管场景的蜂窝网关。将 DJI / 百旺（BAIWANG，Quectel-compatible AT）4G 模块插入 Linux NAS，手机浏览器即可使用该 SIM 卡进行短信和电话操作。
- 短信：收发、会话存储、多端同步
- 电话：WebRTC 呼入/呼出、TURN 中继、通话录音
- 通知：来电与短信 Web Push
- 部署：ARM64 与 amd64 双架构，公开一键脚本自动选择镜像
- 访问：Caddy HTTPS + 手机 PWA，不要求 Tailscale
本项目基于 MacCellular 1.0.0-rc.4 及相关上游工作改造。版权、许可证和必需声明见 LICENSE、NOTICE 与 THIRD_PARTY_NOTICES.md。
| 项目 | 要求 |
|---|---|
| 主机 | Linux ARM64 或 amd64，已安装 Docker Compose |
| 硬件 | 支持的 4G 模块、实体 SIM、USB 连接；本项目验证过 DJI / 百旺 QDC507 语音路径 |
| 域名 | 指向主机公网 IP 的域名；家庭宽带推荐 DuckDNS |
| 权限 | 首次部署需要 root 或可用的 sudo，脚本会自动处理主机 ADB 与串口占用 |
当前双端实测版本没有 --detect-tty 子命令。不要直接假定每台主机都是 /dev/ttyUSB2，先在客户机查看实际设备：
uname -m
ls -l /dev/ttyUSB* /dev/ttyACM* 2>/dev/null本次验证的 DJI / 百旺模块 AT 口为 /dev/ttyUSB2；多模块或不同 USB 拓扑下编号可能变化。确认实际 AT 口后，把它作为第三个参数传给部署脚本。
mkdir -p nasanysim && cd nasanysim
curl -fsSL https://raw.githubusercontent.com/mccding/NasAnySim/main/deploy/deploy.sh -o deploy.sh
chmod 700 deploy.sh
# 把 /dev/ttyUSB2 换成客户机的实际 AT 串口
bash deploy.sh nasanysim.duckdns.org your@email.com /dev/ttyUSB2用户不需要手工编辑脚本、手工 chmod coturn、手工复制证书或手工启动 ADB。脚本会自动：
- 检查 Docker、主机架构和串口；
- 安装/启动仅监听
localhost:5037的 host ADB，并等待它真正就绪； - 停止会抢占模块的 ModemManager（若系统存在）；
- 生成数据密钥、TURN 配置和模块 bootstrap capability；
- 自动处理 coturn
nobody用户所需的目录、配置和证书可读权限； - ARM64 拉取
mccdingding/nasany-sms:latest，amd64 拉取:amd64； - 启动网关、TURN、Caddy 三个容器，并强制重建 TURN 以应用新证书；
- 自动重试模块 bootstrap，直到后端和模块运行时都报告 ready。
完成后访问：
https://你的域名:7577/remote/
新部署默认登录为 admin / admin。只用它完成首次确认，随后立即按下一节修改用户名和密码。
当前镜像的网页没有常驻的账号设置入口。首次部署后请按以下步骤操作：
- 打开
https://你的域名:7577/remote/，使用admin / admin登录一次，确认服务可以访问； - SSH 登录运行 NasAnySim 的 NAS；
- 运行下面的命令。它调用容器内置的一次性重置功能，不需要手工编辑认证文件：
read -r -p '新用户名：' NASANY_NEW_USERNAME
read -r -s -p '新密码（8–128 个字符）：' NASANY_NEW_PASSWORD
printf '\n'
if docker exec nasany-sms /usr/local/bin/djonehub-macos \
-remote-reset-username "$NASANY_NEW_USERNAME" \
-remote-reset-username-file /var/lib/nasany/auth/username \
-remote-reset-password "$NASANY_NEW_PASSWORD" \
-remote-reset-password-file /var/lib/nasany/auth/password-hash; then
unset NASANY_NEW_USERNAME NASANY_NEW_PASSWORD
docker restart nasany-sms
else
unset NASANY_NEW_USERNAME NASANY_NEW_PASSWORD
echo '账号或密码修改失败，容器未重启。' >&2
fi- 等待
nasany-sms恢复运行，然后退出网页中的旧会话，使用新用户名和新密码重新登录； - 再尝试一次
admin / admin，应当登录失败。这可以确认默认凭据已经失效。
安全提示：不要把真实密码直接写在命令、Compose、
.env、截图或公开 issue 中。上面的read -s不会回显密码，也不会把明文密码直接写入 shell history；但内置重置接口仍会在一次性进程参数中短暂接收密码，因此只能在可信的 NAS 管理终端执行。重置进程执行完会立即退出，这是正常行为，随后必须重启nasany-sms才会加载新凭据。
如果忘记了修改后的账号或密码，请使用同一组命令重新设置；更多说明见故障排查。
脚本按以下顺序处理证书：
- 如果部署目录已有
caddy/fullchain.pem和caddy/privkey.pem，使用用户提供的证书； - 如果公网 HTTP-01 条件满足，使用 Let's Encrypt HTTP-01；
- 如果提供 DuckDNS token，使用 Let's Encrypt DNS-01，不依赖公网 80 端口；
- 如果没有可用的真实证书路径，脚本明确失败，不使用容易误导用户的自签名证书作为正式部署结果。
家庭宽带经常无法使用 HTTP-01，因此推荐 DuckDNS DNS-01。交互式终端会提示输入 token；SSH、CI 等非交互环境请使用 .env：
umask 077
printf '%s\n' 'NASANY_DUCKDNS_TOKEN=[REDACTED]' > .env
chmod 600 .env
# 将 [REDACTED] 在本机替换为真实 token；不要提交 .env
bash deploy.sh nasanysim.duckdns.org your@email.com /dev/ttyUSB2DuckDNS 动态 IP 更新已经内置在双端实测脚本里，不需要用户另外下载 updater 或自己写 cron。当部署时同时提供域名和 NASANY_DUCKDNS_TOKEN 时启用；该 token 只应与 DuckDNS 域名一起使用。
部署脚本会：
- 在当前部署目录生成
duckdns-update.sh； - 将 updater 标记为可执行；实际权限受部署目录和系统
umask影响； - 默认使用 DuckDNS 的
ip=源地址检测，让 DuckDNS 根据请求来源更新公网 IP； - 如果明确设置
NASANY_PUBLIC_IP，则固定使用该 IP； - 写入每 5 分钟执行一次的 crontab；
- 将 DuckDNS 返回结果记录到
/var/log/duckdns-update.log。
检查自动更新是否安装：
crontab -l | grep duckdns-update
ls -l duckdns-update.sh
./duckdns-update.sh # 可手工触发一次NASANY_PUBLIC_IP 只在你明确需要绕过代理/TUN 的源地址识别时设置；否则留空即可。非 DuckDNS 域名不要向该脚本提供 DuckDNS token，应使用域名服务商自己的 DDNS 机制。完整流程见 DuckDNS 专项说明。
安全提示：
.env、duckdns-update.sh、证书和私钥都属于本机敏感文件。不要上传、复制给他人或粘贴到公开 issue；如果 token 曾经暴露，请在 DuckDNS 控制台轮换。
以下公网端口需要转发到运行 NasAnySim 的主机 LAN IP：
| 端口 | 协议 | 用途 | 要求 |
|---|---|---|---|
7577 |
TCP | HTTPS PWA 与远程网关 | 必须 |
3478 |
UDP | TURN 初始连接 | 必须 |
49160-49167 |
UDP | TURN relay 音频数据 | 通话必须 |
5349 |
TCP | TURN TLS | 启用 TLS 证书时建议放行 |
以下端口只能在本机或容器内部使用，不要暴露到公网：
| 端口 | 绑定 | 用途 |
|---|---|---|
7576 |
127.0.0.1 |
后端管理/诊断接口 |
7578 |
127.0.0.1 |
Caddy 反代目标 |
5037 |
localhost |
host ADB server |
只转发 7577 而遗漏 49160-49167/UDP，常见结果是网页能打开但通话提示“无法连接公网中继”。完整端口表见 端口与安全边界。
当前双端实测脚本默认启动自带 Caddy，并要求宿主机 7577 可用。NASANY_SKIP_CADDY 不是本次双端验收通过的公开接口；如果客户机已有反向代理占用 7577，不要直接运行当前一键脚本，也不要把内部端口暴露公网，应先完成单独的代理整合与复测。
| 主机架构 | Docker Hub 镜像 |
|---|---|
| ARM64 / AArch64 | mccdingding/nasany-sms:latest |
| amd64 / x86_64 | mccdingding/nasany-sms:amd64 |
脚本自动选择架构，不能在 ARM64 主机手工使用 amd64 镜像，也不能反过来使用。运行时镜像为闭源预编译分发；本仓库不会包含源码、Go 缓存、客户机证书或构建上下文。
- 用 Safari 或 Chrome 打开
https://你的域名:7577/remote/； - 登录后按“首次登录后修改用户名和密码”一节停用默认凭据；
- iPhone 选择“分享 → 添加到主屏幕”，Android 可使用浏览器菜单安装 PWA；
- 首次通话前确认路由器已转发 TURN 端口范围。
- 没有串口：检查
/dev/ttyUSB*、/dev/ttyACM*，确认模块 USB 连接和实际 AT 串口； - 网页打不开：检查
7577/TCP、域名解析和 Caddy 容器日志； - 网页能开但无法连接中继：检查
3478/UDP、49160-49167/UDP，并优先确认5349/TCP与证书； - 证书申请失败：家庭宽带使用 DuckDNS token 走 DNS-01，不要反复重试 HTTP-01；
- ADB 报错：脚本应自动安装并绑定
localhost:5037，检查systemctl status nasany-adb-server.service； - ModemManager 抢串口：脚本会自动停用；若发行版没有 systemd，手工确认没有其他进程打开 TTY。
更多处理步骤见 故障排查。
当前 deploy/deploy.sh 已字节级恢复为 ARM64 与 amd64 清洁环境实际通过的同一份脚本，SHA-256 为 bd9f02a8ff7d5cd6871467f394d45967e446978e770a31c9c5a32b2b9ec104de。从 Docker Hub 拉取镜像、DNS-01 证书、TURN TLS 5349、host ADB loopback、模块 bootstrap/语音运行时，以及真实电话/短信闭环均已验证。详细记录见 双架构验收记录。
本项目以预编译 Docker 镜像形式发布，个人自托管使用免费；禁止商用倒卖、改皮转卖和再分发镜像及其内容。完整条款以 LICENSE 为准。
感谢以下上游与参考项目：
- MacCellular：早期 macOS 短信/电话网关；
- VoHive / DJOneHub：早期 USB/AT、eSIM 与模块管理基础；
- MaVo：UAC 探测与 QDC507 音频路径参考；
- Pion WebRTC、libusb、coturn 及其他运行时依赖。
完整声明见 NOTICE 与 THIRD_PARTY_NOTICES.md。
如果本项目对你有帮助，欢迎支持它的开发：
微信扫码支持 · Scan to support