# frp-admin-ui **Repository Path**: creekmoon/frp-admin-ui ## Basic Information - **Project Name**: frp-admin-ui - **Description**: FPR可视化UI 支持一键下发穿透指令 - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2026-10-20 - **Last Updated**: 2026-10-23 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # frp-admin-ui frp 控制台:可视化查看 frps 运行状态,按场景生成 frpc-single 的 docker-compose 或 docker run 命令,让目标机器一键完成内网穿透部署。单容器 nginx 镜像,与 frps 同机部署,已发布 [Docker Hub](https://hub.docker.com/r/yinjiangyue/frp-admin-ui),compose 启动即用。 ## 能做什么 / 不能做什么 **能:** - 概览 frps 实时状态:版本、在线客户端(frpc 版本/wire 协议)、代理列表、对外端口占用、流量与连接数,15 秒自刷(数据走 frps dashboard v2 API,需 frps ≥ 0.70) - 按场景生成 [frpc-single](https://hub.docker.com/r/yinjiangyue/frpc-single) 的 docker-compose 或 docker run 单行命令(输入实时预览,无需点击生成),一键复制/下载;端口冲突即时提示 - 离线分发 frpc-single 镜像(内置 `docker save` 包),目标机器拉不动 Docker Hub 也能部署 **不能:** - 不创建、不修改 frps 本体配置——token 同步、端口放行仍需人工到服务端操作 - 不存隧道台账:无应用后端,页面状态以 frps 实时 API 为准,容器重建不留痕(token 除外,见下文) - 单 basic-auth 账号,无多用户与权限体系;客户端镜像名硬绑定(`FRPC_IMAGE` 常量),不支持多镜像 ## 它在链路里的位置 ``` 管理员浏览器 ──▶ frp-admin-ui ──/api 反代注入认证──▶ frps dashboard API(:7500) │ 生成 compose / docker run ▲ 穿透注册 ▼ │ 目标机: 一键执行 ──▶ frpc-single ────────────┘ ``` ## 快速启动 ```yaml services: frp-admin-ui: image: yinjiangyue/frp-admin-ui:0.5.0 container_name: frp-admin-ui restart: unless-stopped environment: ADMIN_USER: admin ADMIN_PASSWORD: change-me FRP_SERVER_IP: 1.2.3.4 FRPS_API_URL: http://frps:7500 FRPS_DASHBOARD_USER: admin FRPS_DASHBOARD_PASSWORD: admin ports: - "8080:80" volumes: - frp-admin-ui-data:/data volumes: frp-admin-ui-data: ``` 访问 `http://<宿主机IP>:8080`(basic auth 登录)。环境变量说明见下表。 ## 环境变量 | 变量 | 说明 | 默认 | | --- | --- | --- | | `FRP_SERVER_IP` | frps 地址,页面只读展示并写入生成的 compose | 必填 | | `ADMIN_USER` / `ADMIN_PASSWORD` | 页面 basic auth | `admin` / 启动时自动生成并打印到日志 | | `FRP_SERVER_PORT` | frps 服务端口 | `7000` | | `FRPS_API_URL` | frps dashboard API 地址;同 compose 网络填服务名,否则填 `http://:7500`(需映射 7500) | `http://frps:7500` | | `FRPS_DASHBOARD_USER` / `FRPS_DASHBOARD_PASSWORD` | frps 控制台账号(frps 的 `UI_USER_NAME` / `UI_USER_PASS_WORD`) | `admin` / `admin` | ## 使用主路径 1. **同步 token**(仅首次):页面「配置生成器」页复制自动生成的 token,配置到 frps 的 `CLIENT_TOKEN` 并重启 frps 2. 「概览」页确认 frps 在线、客户端与代理状态正常 3. 「配置生成器」页勾选场景、填写目标地址,下方实时产出 docker-compose 或 docker run 两种形态 4. compose 拷到目标机器 `docker compose up -d`,或直接粘贴 docker run 命令执行;`docker logs frpc` 出现 `start proxy success` 即成功 5. 回到「概览」页,可见新代理上线与端口占用 目标机器拉不动 Docker Hub 时走离线装载分支(见下)。 ## 场景能力 | 场景 | 生成配置要点 | 适用 | | --- | --- | --- | | 四层 TCP(默认开启) | `TARGET_IP` `TARGET_PORT` `REMOTE_PORT` | 任意 TCP 服务(SSH、数据库等)按端口暴露 | | 七层 HTTP(可选叠加) | 追加 `HTTP_REMOTE_PORT` `HTTP_TARGET_IP` `HTTP_TARGET_PORT`,可选 `HTTP_HOST_HEADER` | HTTP 服务按独立端口暴露;后端按 Host 分流(nginx `server_name`)时用 Host 头改写防 404 | | 七层 HTTPS 后端 | 再追加 `HTTP_TARGET_SCHEME: https` | 后端为 HTTPS;不校验后端证书,过期/自签可用 | 三者关系:四层为默认底座始终开启,七层在其上叠加,一容器一条四层 + 至多一条七层。多条穿透生成多份 compose(或多次执行 docker run)。 ## 离线装载(拉不动 Docker Hub 的分支) ```bash curl -sSL http://<控制台地址>/dl/frpc-single-0.71.0.tar.gz | docker load ``` `/dl/` 匿名下载(公开镜像无泄密面);装载后镜像名与原仓库一致,compose 无需修改。Windows(PowerShell)目标机请分两步:`curl.exe -O` 下载后 `docker load -i`。 ## token 管理 - 首次启动自动生成 UUID 写入 `/data/frp_token`,页面只读展示 + 一键复制;不挂 `/data` 卷则容器重建后重新生成,需重新同步 frps - 轮换:`docker exec frp-admin-ui rm /data/frp_token && docker restart frp-admin-ui`,刷新页面获取新 token 后重新同步 frps 与全部已部署客户端 ## 维护 ``` index.html 单文件前端(概览 + 生成器,无框架无 CDN 依赖) default.conf.template nginx 站点模板: basic auth + /dl/ 匿名 + /api/ 反代注入认证 docker-entrypoint.d/40-gen-config.sh 启动时生成 htpasswd / config.js / nginx conf(envsubst) Dockerfile / docker-compose.yaml 构建与部署样例 dl/frpc-single-*.tar.gz frpc-single 离线分发包(docker save) save-frpc-single.ps1 离线包再生成脚本 ``` 客户端版本升级时:① 构建推送新版 `yinjiangyue/frpc-single:`;② 改 `index.html` 的 `FRPC_IMAGE` 常量(一处,`/dl/` 链接与装载命令按 tag 自动推导);③ 执行 `save-frpc-single.ps1 -Tag ` 重新生成离线包(**须用脚本内的 alpine gzip**——Windows 自带 bsdtar 生成的 gzip 流 `docker load` 不识别);④ 重建本镜像并更新 compose tag。本地构建:`docker build -t yinjiangyue/frp-admin-ui: .` ## 配套镜像 - [yinjiangyue/frps](https://hub.docker.com/r/yinjiangyue/frps):frp 服务端封装(dashboard API 为概览页数据源) - [yinjiangyue/frpc-single](https://hub.docker.com/r/yinjiangyue/frpc-single):frp 客户端封装(生成器的目标产物)