Docker 教程
登录注册

🐳 Docker 客户端 · 各品牌 NAS 使用教程

镜像包已预构建好，全程图形界面、无需懂命令行。按你的 NAS 品牌对照操作即可，不同固件版本菜单文字略有差异，认准「镜像导入」「创建容器」这类入口。

✅ 开始之前：两样东西 所有品牌通用

  1. 访问密钥（token）：先登录，在「Linux 脚本」标签页复制密钥，形如一长串字符，容器靠它拉取你的隧道配置。
  2. 镜像包：按 NAS 的 CPU 下载（不确定就选 amd64，绝大多数 x86 款 NAS 都是它；ARM 款盒子选 arm64）：
  3. 创建容器时的三项关键设置（每个品牌都一样）：① 环境变量 NFRP_TOKEN = 你的密钥；② 网络模式选 host（主机网络）；③ 重启策略选 always / 总是 / 开机自启。
💡 判断 CPU 架构：在 NAS 系统信息页看 CPU 型号——Intel 赛扬/奔腾/酷睿、AMD 都是 amd64；瑞芯微 RK3588、高通等 ARM 芯片选 arm64。选错了容器会启动失败，删掉换另一个包即可，不会搞坏系统。
🐂 飞牛 fnOS 🟦 群晖 Container Manager ⚪ 威联通 Container Station 🟩 绿联 UGOS 🔷 极空间 ⌨️ Linux / SSH 命令行 ❓ 常见问题

🐂飞牛 fnOS（推荐：镜像导入）

  1. 打开飞牛的「文件」管理器，把下载好的 nfrp-frpc-amd64.tar 上传到任意共享文件夹（例如新建一个 docker 文件夹放进去）。
  2. 打开「Docker」套件（没有的话先在应用中心安装）。
  3. 左侧选「镜像」，点右上角 「导入」（有的版本叫「添加 → 导入镜像」），选择刚才上传的 tar 文件，确定后等待导入，列表出现 nfrp-frpc:latest 即成功。
  4. 左侧选「容器」，点 「创建」，镜像选择 nfrp-frpc:latest，容器名可填 nfrp-frpc。
  5. 进入高级设置：网络模式选 host（主机网络）；环境变量里添加一条 NFRP_TOKEN，值填你的密钥；重启策略选 always（总是重启）。
  6. 点创建/启动，容器状态变为「运行中」。点容器的「日志」，看到「配置获取成功，启动 frpc」字样就全部完成了。
⌨️ 找不到导入入口？飞牛开启 SSH 后执行一条命令即可导入，图形界面随后能看到镜像：
docker load -i /vol1/1000/docker/nfrp-frpc-amd64.tar
（路径按你实际上传位置调整，可在文件管理器里右键复制路径。）

🟦群晖 Synology Container Manager

方式 A：镜像导入（最省事）
  1. 打开 File Station，把 nfrp-frpc-amd64.tar 上传到共享文件夹（如 docker）。
  2. 打开 Container Manager（DSM 6 旧版叫「Docker」套件），左侧进入「映像」。
  3. 点 「新增」旁的下拉 / 「导入」，选择从本地文件导入，选中上传的 tar，等待映像列表出现 nfrp-frpc:latest。
  4. 选中该映像，点 「运行 / 创建容器」：容器名 nfrp-frpc；勾选启用自动重启。
  5. 高级设置里：网络选项卡网络模式选 host（主机）；环境变量选项卡新增 NFRP_TOKEN = 你的密钥。
  6. 应用启动，容器变「运行中」；在「容器 → 日志」看到「配置获取成功」即完成。
方式 B：项目（docker compose，自动构建）
  1. 从 客户端下载标签页 下载 Dockerfile 和 docker-compose.yml，连同放在 File Station 的同一文件夹（如 docker/nfrp-frpc）。
  2. 用文本编辑器套件打开 docker-compose.yml，把 NFRP_TOKEN=在此填入你的访问密钥 改成你的密钥并保存。
  3. Container Manager → 「项目」→「新增」，项目名 nfrp-frpc，路径选择刚才的文件夹，确定。
  4. 群晖会自动构建镜像并启动（首次 1~3 分钟，全程国内源），项目状态变绿即成功。
⌨️ 「映像」页没有导入按钮的旧版本：控制面板开启 SSH 后执行：
sudo docker load -i /volume1/docker/nfrp-frpc-amd64.tar
再回 Container Manager 的映像页即可看到镜像。

⚪威联通 QNAP Container Station

  1. 打开 File Station，把 nfrp-frpc-amd64.tar 上传到共享文件夹。
  2. 打开 Container Station（App Center 里先安装）。
  3. 左侧进入「映像」，点 「导入」（部分版本在「提取」按钮旁的下拉里，叫「从本地文件导入」），选择上传的 tar 文件开始导入。
  4. 导入完成后，在映像列表选中 nfrp-frpc:latest，点 「创建 / 创建容器」。
  5. 高级设置：网络模式选 host；环境变量添加 NFRP_TOKEN = 你的密钥；重启原则选 always。
  6. 创建启动，容器状态为 running；用「日志 / 控制台」查看，出现「配置获取成功，启动 frpc」即完成。
⌨️ SSH 兜底（控制台开启 SSH 后）：
docker load -i /share/Container/nfrp-frpc-amd64.tar

🟩绿联 UGOS / UGOS Pro

  1. 打开「文件管理」，把 nfrp-frpc-amd64.tar 上传到 NAS（建议放到 Docker 相关目录）。
  2. 打开 Docker 应用（UGOS Pro 在应用中心安装「Docker」）。
  3. 左侧进入「镜像」，点 「添加 / 导入」，选择本地文件导入，选中 tar 文件，等待导入完成出现 nfrp-frpc:latest。
  4. 选中镜像点 「创建容器」，名称填 nfrp-frpc。
  5. 高级设置：网络选 host（主机网络）；环境变量新增 NFRP_TOKEN = 你的密钥；重启策略选「总是」，并勾选开机自动启动。
  6. 完成创建，容器状态「运行中」；点「日志」确认出现「配置获取成功，启动 frpc」。
⌨️ SSH 兜底（设置中开启 SSH 后）：
docker load -i /mnt/media_rw/你的目录/nfrp-frpc-amd64.tar

🔷极空间 zSpace

  1. 打开「文件管理」，把 nfrp-frpc-amd64.tar 上传到个人空间或共享文件夹。
  2. 打开 Docker 应用（需在「我的应用」中找到并打开，部分型号需先开启 Docker 功能）。
  3. 进入「镜像」，点 「导入镜像 / 本地导入」，选择上传的 tar 文件，等待导入，列表出现 nfrp-frpc:latest。
  4. 选中镜像点 「创建容器」，容器名 nfrp-frpc。
  5. 设置中：网络模式选 host（主机）；环境变量添加 NFRP_TOKEN = 你的密钥；勾选「启用自动重启 / 开机自启」。
  6. 启动容器，状态「运行中」；打开「日志」看到「配置获取成功，启动 frpc」即完成。
⌨️ SSH 兜底（极空间需在设置中开启 SSH 功能）：
docker load -i /tmp/zspace/nfrp-frpc-amd64.tar

⌨️Linux / NAS SSH 命令行方式

会用命令行的话，三种方式任选其一，效果和图形界面完全一样。

① 离线镜像包导入（推荐，不依赖 NAS 联网构建）
docker load -i nfrp-frpc-amd64.tar && docker run -d --name nfrp-frpc --restart=always --network host -e NFRP_TOKEN=你的密钥 nfrp-frpc:latest
② 在线构建（一条命令，自动识别架构）
mkdir nfrp-frpc && cd nfrp-frpc && curl -sSL -O https://nfrp.yma1.com/dl/docker/Dockerfile && docker build -t nfrp-frpc . && docker run -d --name nfrp-frpc --restart=always --network host -e NFRP_TOKEN=你的密钥 nfrp-frpc
③ 常用运维命令
docker logs -f nfrp-frpc   # 看日志  |  docker restart nfrp-frpc   # 重启（会重新拉取隧道配置） |  docker rm -f nfrp-frpc   # 卸载

❓ 常见问题

Q1：容器状态显示运行中，但隧道用不了？
打开容器日志看最后几行：出现「无法获取隧道配置」说明密钥填错了——检查环境变量名必须是 NFRP_TOKEN（全大写、下划线），值是客户端脚本页的完整密钥，不要带空格；出现「启动 frpc」但外网不通，去网站检查隧道状态和本地服务是否正常。

Q2：host 网络找不到 / 选不了？
群晖、飞牛、绿联、极空间、威联通的 Linux 版 Docker 都支持 host 模式（通常在网络设置的下拉里）。如果你的系统是 Windows / Mac 上的 Docker Desktop，则不支持 host，改为默认 bridge 网络即可——穿透局域网其他设备不受影响（隧道里填设备内网 IP）。

Q3：我要穿透的不是 NAS 本机，是家里另一台设备？
无需特殊网络设置。容器跑在 NAS 上后，在网站的隧道配置里，「内网地址」填那台设备的局域网 IP（如 192.168.1.100）即可，NAS 会把流量转发过去。

Q4：在网站改了隧道配置，容器里要做什么？
容器每次启动都会拉取最新配置，重启一下容器即可（图形界面点「重启」，或 docker restart nfrp-frpc），无需重新导入镜像。

Q5：镜像选错架构（amd64/arm64）会怎样？
容器会反复重启或启动即退出，日志里有 exec format error 之类字样。删掉容器、换另一个镜像包导入即可，对 NAS 系统无任何影响。

Q6：导入镜像很慢或失败？
镜像包只有约 10MB，一般很快；失败多为上传 tar 时不完整——重新下载/上传一次，确认文件大小约 10MB 再导入。导入后镜像不联网下载任何东西，构建过程已在服务器完成。

Q7：想更新镜像怎么办？
本页面提供的镜像长期可用，一般无需更新。网站发布新版镜像后，下载新 tar 重新导入，删除旧容器、用新镜像按同样三项设置重建即可（配置都在服务端，不丢隧道）。

Q8：卸载干净？
图形界面：删除容器 → 删除镜像 nfrp-frpc:latest 即可；命令行：docker rm -f nfrp-frpc && docker rmi nfrp-frpc:latest。

← 回客户端下载标签页 / 获取镜像包与 Dockerfile