首页下载文档用户注册用户登录
Documentation · 使用文档

Docker 版 AFRP 客户端使用指南

Docker 版 AFRP 内网穿透客户端,通过浏览器管理 frpc。无需安装桌面应用,一键部署即可使用。
Github仓库:https://github.com/afrpnet/afrp-docker
Docker仓库:https://hub.docker.com/r/afrp/afrp

特性

  • 🌐 纯 Web 界面:浏览器访问,跨平台兼容,无需安装客户端
  • 🔐 OIDC 认证:复用官网账号登录,密钥按账号独立保存
  • 👥 多账号切换:登录页可保存多个账号,一键切换,各自记住服务器与密钥
  • 🖥 服务器记忆:每个账号记住上次选择的服务器,登录后自动回填,无需重新选择
  • 🔒 连接中锁定:frpc 运行期间服务器下拉框锁定,避免误切节点导致断连
  • 🛠 隧道管理:Web 界面增删改隧道(TCP/UDP/HTTP/HTTPS/STCP/SUDP/XTCP)
  • 📊 实时日志:Web 界面查看 frpc 运行日志
  • 💾 配置持久化:Docker volume 保存配置、密钥、隧道
  • ✅ 官方内核:直接使用 fatedier/frp 官方镜像中的 frpc,保证版本正确性

快速开始

# 拉取镜像
docker pull afrp/afrp

# 运行容器
docker run -d \
  --name afrp-web \
  --restart unless-stopped \
  -p 8000:8000 \
  -p 7400:7400 \
  -v afrp-data:/data \
  afrp/afrp

⚠️ -v afrp-data:/data 必须挂载。配置、Client Secret、隧道都存放在 /data 下,漏挂卷会新建匿名卷,表现为「重启后又要重新登录、密钥又变成未设置」。

💡 -p 7400:7400 是 frpc 自带管理面板的端口,映射后容器外才能打开面板;不用管理面板可以不映射。

访问 Web UI:http://localhost:8000

使用说明

  1. 登录:输入官网账号和密码,勾选「记住我」可保存账号以便下次一键登录
  2. 服务器:选择节点。系统会按账号记住这次选择,下次登录自动回填;frpc 运行期间下拉框锁定,需先停止才能切换
  3. Client Secret:首次使用需粘贴官网「连接说明」里的密钥,或在页面点击「生成新密钥」由官网接口签发。密钥按账号保存,切换账号时自动取用对应密钥并写入 frpc.toml
  4. 隧道:点击「+ 添加隧道」填写名称、类型、本地 IP/端口等信息,保存后自动重启 frpc 使其立即生效;「隧道管理」标题右侧的「配置文件」可打开 frpc.toml 直接编辑,保存后文件里的隧道会同步到隧道列表,并自动重启 frpc;在 frpc 管理面板的「配置」页改过 frpc.toml 后,回到网页点「刷新」即可看到这些隧道
  5. 启动:点击「启动」按钮,frpc 开始运行;「停止」可断开
  6. 管理面板:「状态」下方的小字勾选项「启用 frpc 管理面板」可开启 frpc 自带的 Web 面板,勾选后自动生成随机账号密码、写入 frpc.toml 的 webServer 段和 [store] 段并重启 frpc,下方会显示面板地址、账号和密码(Docker 部署需映射该端口,-p 7400:7400)
  7. 监控:查看运行状态与实时日志
  8. 主题:登录卡片右上角(登录后位于「退出登录」旁)可切换深色 / 浅色,默认跟随系统,选择结果记在浏览器本地

升级

镜像发布后按以下顺序更新(务必保留数据卷):

docker stop afrp-web && docker rm afrp-web
docker pull afrp/afrp:latest
docker run -d --name afrp-web --restart unless-stopped -p 8000:8000 -p 7400:7400 -v afrp-data:/data afrp/afrp:latest

配置说明

数据持久化

配置和日志保存在 Docker volume afrp-data 中:

# 查看配置目录
docker exec afrp-web ls /data

# 备份配置
docker run --rm -v afrp-data:/data -v $(pwd):/backup alpine tar czf /backup/afrp-backup.tar.gz /data

# 恢复配置
docker run --rm -v afrp-data:/data -v $(pwd):/backup alpine tar xzf /backup/afrp-backup.tar.gz -C /
路径 说明
/data/config/config.json 主配置:账号、服务器、密钥、隧道列表
/data/config/frpc.toml 自动生成的 frpc 配置,启动时直接使用
/data/config/frpc_store.json 管理面板的代理存储文件(启用管理面板后生成)
/data/logs/frpc.log frpc 运行日志

config.json 中几个关键字段:

字段 说明
user 当前登录的官网用户名(frpc 的 clientID 即此值)
account_secrets 账号 → Client Secret 映射,切换账号时按账号取用
account_servers 账号 → 最后选择的服务器 ID,登录时自动恢复
client_secret 当前账号的密钥(旧版单账号配置,升级后会自动归档进 account_secrets)

管理面板与隧道管理

「状态」下方勾选「启用 frpc 管理面板」后,页面自动生成随机账号密码并写入 frpc.toml 的 webServer 段与 [store] 段,同时重启 frpc 使配置生效;下方提示里会给出面板地址、账号和密码。

启用管理面板后,frpc 会在代理存储文件 /data/config/frpc_store.json 中记录面板里增删改的隧道。

  • 「隧道管理」列表会合并三处记录:网页里添加的隧道、面板里创建的隧道、frpc.toml 里的隧道,点「刷新」即可看到最新改动
  • 面板创建的隧道会并入 config.json 的隧道列表,之后可以直接在网页里编辑、删除;改动同时写回存储文件,frpc 侧保持一致
  • 面板的「配置」页直接改写 /data/config/frpc.toml,改动后点「刷新」,这些隧道同样会并入列表,标有「配置文件」角标
  • 在 frpc.toml 里改了 webServer.user / webServer.password,账号密码会同步回 config.json,页面提示里的账号密码随之改变,重新生成配置时也不会被旧值覆盖
  • 名称相同的隧道以面板记录为准,避免 frpc 因代理重名启动失败
  • 隧道增删改后会重新生成 frpc.toml 并重启 frpc,改动立即生效
  • 重新生成 frpc.toml 时会保留面板设置的其它字段(如 transport.useEncryption),不会因为在网页里编辑就丢失
  • 字段不全的隧道(缺 name/type/localIP/localPort,或 http 缺域名)在 frpc.toml 里整段注释掉,不会让 frpc 启动失败,补全后自动恢复
  • frpc 启动时同样会校验存储文件里的代理,所以存储文件里字段不全的记录会被自动清掉,配置仍保留在隧道列表里待修复
  • 未启用管理面板时,frpc 不加载代理存储文件,列表只显示网页里的隧道和 frpc.toml 里的隧道