147 lines
2.9 KiB
Markdown
147 lines
2.9 KiB
Markdown
## 📦 二进制安装指南
|
||
|
||
> 直接下载编译好的二进制文件，开箱即用，无需 Docker、无需 Go 环境。
|
||
|
||
|
||
### 一、📥 下载
|
||
|
||
从 [Releases](https://git.whitetop.xyz/lxh2875931338/frpc-console/releases) 页面下载对应平台的二进制文件：
|
||
|
||
| 平台 | 文件名 |
|
||
|---|---|
|
||
| Linux x86-64 | `frpc-console-linux-amd64.tar.gz` |
|
||
| Linux ARM64 | `frpc-console-linux-arm64.tar.gz` |
|
||
| Windows x86-64 | `frpc-console-windows-amd64.zip` |
|
||
|
||
|
||
### 二、🐧 Linux 部署
|
||
|
||
**1. 解压并放好**
|
||
|
||
```bash
|
||
tar -xzf frpc-console-linux-amd64.tar.gz
|
||
sudo mv frpc-console-linux-amd64 /usr/local/bin/frpc-console
|
||
sudo chmod +x /usr/local/bin/frpc-console
|
||
```
|
||
|
||
**2. 直接运行**
|
||
|
||
```bash
|
||
./frpc-console
|
||
```
|
||
|
||
默认监听 `http://localhost:9300`。
|
||
|
||
**3. 注册为 systemd 服务（推荐，开机自启）**
|
||
|
||
创建服务文件：
|
||
|
||
```bash
|
||
sudo nano /etc/systemd/system/frpc-console.service
|
||
```
|
||
|
||
写入：
|
||
|
||
```ini
|
||
[Unit]
|
||
Description=frpc-console
|
||
After=network.target
|
||
|
||
[Service]
|
||
Type=simple
|
||
User=root
|
||
WorkingDirectory=/opt/frpc-console
|
||
ExecStart=/usr/local/bin/frpc-console
|
||
Restart=always
|
||
RestartSec=10
|
||
|
||
[Install]
|
||
WantedBy=multi-user.target
|
||
```
|
||
|
||
启动并启用：
|
||
|
||
```bash
|
||
sudo systemctl daemon-reload
|
||
sudo systemctl enable frpc-console
|
||
sudo systemctl start frpc-console
|
||
sudo systemctl status frpc-console
|
||
```
|
||
|
||
|
||
### 三、🪟 Windows 部署
|
||
|
||
**1. 解压**
|
||
|
||
将 `frpc-console-windows-amd64.zip` 解压到目标文件夹，比如 `C:\frpc-console\`。
|
||
|
||
**2. 直接运行**
|
||
|
||
双击 `frpc-console.exe`，或打开命令行：
|
||
|
||
```cmd
|
||
cd C:\frpc-console
|
||
frpc-console.exe
|
||
```
|
||
|
||
默认监听 `http://localhost:9300`。
|
||
|
||
**3. 后台运行（隐藏窗口）**
|
||
|
||
方式一：使用 `start /b`
|
||
|
||
```cmd
|
||
start /b frpc-console.exe
|
||
```
|
||
|
||
方式二：使用 `nssm` 注册为 Windows 服务
|
||
|
||
```cmd
|
||
nssm install frpc-console
|
||
# 按提示填写路径
|
||
nssm start frpc-console
|
||
```
|
||
|
||
|
||
### 四、🚀 首次访问
|
||
|
||
启动后，浏览器打开：
|
||
|
||
```
|
||
http://localhost:9300
|
||
```
|
||
|
||
首次访问会自动跳转到注册页面，填写用户名和密码，完成管理员账户创建。
|
||
|
||
登录后，在「隧道列表」页面点击「导入 TOML」，即可将现有的 `frpc.toml` 迁移到 WebUI 中管理。
|
||
|
||
|
||
### 五、📂 数据目录说明
|
||
|
||
默认情况下，数据文件会生成在与二进制同级的目录下：
|
||
|
||
| 文件 | 说明 |
|
||
|---|---|
|
||
| `frpc-console.db` | SQLite 数据库 |
|
||
| `frpc.toml` | 生成的 frpc 配置文件 |
|
||
| `frpc.log` | frpc 运行日志 |
|
||
| `frpc.pid` | frpc 进程 PID（Linux） |
|
||
|
||
建议将数据目录单独存放，便于备份和迁移。
|
||
|
||
|
||
### 六、🔄 升级
|
||
|
||
下载新版本二进制，覆盖旧文件，重启服务即可。数据文件会自动保留，无需额外操作。
|
||
|
||
**Linux systemd 升级：**
|
||
|
||
```bash
|
||
sudo systemctl stop frpc-console
|
||
sudo cp frpc-console-linux-amd64 /usr/local/bin/frpc-console
|
||
sudo systemctl start frpc-console
|
||
```
|
||
|
||
**Windows 升级：**
|
||
|
||
停止旧进程，替换 `frpc-console.exe`，重新运行。 |