140 lines
3.4 KiB
Markdown
140 lines
3.4 KiB
Markdown
## 🐳 Docker 版安装指南
|
||
|
||
> 推荐方式：一键脚本自动部署，无需手动编译，无需安装 Go 环境。</br>
|
||
|
||
> ⚠️ **注意**：Docker 版直接从源码构建，使用的是当前 `main` 分支的最新代码，更新进度会远快于 Release 版本。⚠️</br>
|
||
> 如需使用特定版本（如 LTS），请查看 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 确认版本号，并通过二进制方式部署指定版本。
|
||
|
||
### 一、📥 前置条件
|
||
|
||
- 已安装 Docker（必须）
|
||
- 已安装 curl / wget（脚本会自动检查并安装）
|
||
- 操作系统：Linux（x86_64 / ARM64 均可，ARMv7 将在不久的未来得到支持）
|
||
|
||
|
||
### 二、🚀 一键部署（推荐）
|
||
|
||
在目标 Linux 服务器上执行：
|
||
|
||
```bash
|
||
curl -sSL https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/deploy.sh | sudo bash
|
||
```
|
||
|
||
或手动下载执行：
|
||
|
||
```bash
|
||
wget https://git.whitetop.xyz/lxh2875931338/frpc-console/raw/main/deploy.sh
|
||
chmod +x deploy.sh
|
||
sudo bash deploy.sh
|
||
```
|
||
|
||
|
||
### 三、⚙️ 脚本自动完成内容
|
||
|
||
| 步骤 | 说明 |
|
||
|---|---|
|
||
| 检测系统 | 自动识别 OpenSUSE（猫猫特有的夹带私货） / Ubuntu / Debian / CentOS / Alpine |
|
||
| 检测 CPU 架构 | 自动适配 x86_64 / ARM64 / ARMv7 |
|
||
| 安装依赖 | git / curl / wget（如未安装） |
|
||
| 安装 Go | 从国内镜像下载，自动配置代理 |
|
||
| 拉取源码 | 从 Gitea 仓库克隆最新代码 |
|
||
| 编译二进制 | 根据当前架构编译 Linux 版 |
|
||
| 构建 Docker 镜像 | 使用源码中的 Dockerfile 构建 |
|
||
| 启动容器 | 挂载数据卷，开机自启 |
|
||
|
||
|
||
### 四、📂 数据持久化
|
||
|
||
脚本默认将数据存储在 `/opt/frpc-console/data/`：
|
||
|
||
| 文件 | 说明 |
|
||
|---|---|
|
||
| `frpc-console.db` | SQLite 数据库（用户、隧道、配置） |
|
||
| `frpc.toml` | 生成的 frpc 配置文件 |
|
||
| `frpc.log` | frpc 运行日志 |
|
||
| `frpc.pid` | frpc 进程 PID |
|
||
|
||
升级或重建容器时，数据自动保留，不会丢失。
|
||
|
||
|
||
### 五、🔄 升级
|
||
|
||
**方式一：重新运行脚本**
|
||
|
||
```bash
|
||
sudo bash deploy.sh
|
||
```
|
||
|
||
脚本会自动停止旧容器、拉取最新代码、重新编译并启动新容器，数据卷保持不变。
|
||
|
||
**方式二：手动更新**
|
||
|
||
```bash
|
||
# 停止旧容器
|
||
docker stop frpc-console
|
||
docker rm frpc-console
|
||
|
||
# 重新运行 deploy.sh
|
||
sudo bash deploy.sh
|
||
```
|
||
|
||
|
||
### 六、🧹 常用命令
|
||
|
||
```bash
|
||
# 查看日志
|
||
docker logs -f frpc-console
|
||
|
||
# 查看 frpc 子进程状态
|
||
docker exec frpc-console ps aux | grep frpc
|
||
|
||
# 重启容器
|
||
docker restart frpc-console
|
||
|
||
# 停止容器
|
||
docker stop frpc-console
|
||
|
||
# 启动容器
|
||
docker start frpc-console
|
||
```
|
||
|
||
|
||
### 七、🌐 访问地址
|
||
|
||
部署完成后，浏览器打开：
|
||
|
||
```
|
||
http://你的服务器IP:9300
|
||
```
|
||
|
||
首次访问会自动跳转到注册页面，填写用户名和密码，完成管理员账户创建。
|
||
|
||
登录后，在「隧道列表」页面点击「导入 TOML」，即可将现有的 `frpc.toml` 迁移到 WebUI 中管理。
|
||
|
||
|
||
### 八、📌 手动部署（不使用脚本）
|
||
|
||
如果你已有源码，或想自行定制：
|
||
|
||
```bash
|
||
# 1. 克隆代码
|
||
git clone https://git.whitetop.xyz/lxh2875931338/frpc-console.git
|
||
cd frpc-console
|
||
|
||
# 2. 构建镜像
|
||
docker build -t frpc-console:latest .
|
||
|
||
# 3. 创建数据目录
|
||
mkdir -p /opt/frpc-console/data
|
||
|
||
# 4. 启动容器
|
||
docker run -d \
|
||
--name frpc-console \
|
||
--restart=always \
|
||
--network host \
|
||
-v /opt/frpc-console/data:/app/data \
|
||
-e PORT=9300 \
|
||
-e TZ=Asia/Shanghai \
|
||
frpc-console:latest
|
||
```
|