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