frpc-console/install_binary.md

文件：INSTALL_BINARY.md

# 📦 二进制安装指南

> 直接下载编译好的二进制文件，开箱即用，无需 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. 直接运行

# 前台运行，方便查看日志
./frpc-console

# 或指定端口
./frpc-console -p 9300

3. 注册为 systemd 服务（推荐，开机自启）

创建服务文件：

sudo nano /etc/systemd/system/frpc-console.service

写入以下内容：

[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

启动并启用：

sudo systemctl daemon-reload
sudo systemctl enable frpc-console
sudo systemctl start frpc-console
sudo systemctl status frpc-console

---

好，帮你补全字标和格式，直接复制就能用：

---

📦 二进制安装指南

直接下载编译好的二进制文件，开箱即用，无需 Docker、无需 Go 环境。

一、📥 下载

从 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. 解压并放好

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. 直接运行

./frpc-console

默认监听 http://localhost:9300。

3. 注册为 systemd 服务（推荐，开机自启）

创建服务文件：

sudo nano /etc/systemd/system/frpc-console.service

写入：

[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

启动并启用：

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，或打开命令行：

cd C:\frpc-console
frpc-console.exe

默认监听 http://localhost:9300。

3. 后台运行（隐藏窗口）

方式一：使用 start /b

start /b frpc-console.exe

方式二：使用 nssm 注册为 Windows 服务

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 升级：

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，重新运行。