补充部分安装文档

This commit is contained in:
2026-07-24 23:59:38 +08:00
parent bf9e373d33
commit 24f5766568
2 changed files with 234 additions and 9 deletions
+233
View File
@@ -0,0 +1,233 @@
文件:INSTALL_BINARY.md
```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
# 或指定端口
./frpc-console -p 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
```
---
好,帮你补全字标和格式,直接复制就能用:
---
## 📦 二进制安装指南
> 直接下载编译好的二进制文件,开箱即用,无需 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 进程 PIDLinux |
建议将数据目录单独存放,便于备份和迁移。
### 六、🔄 升级
下载新版本二进制,覆盖旧文件,重启服务即可。数据文件会自动保留,无需额外操作。
**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`,重新运行。
+1 -9
View File
@@ -125,15 +125,7 @@ go build -ldflags="-s -w" -o frpc-console .
--- ---
### 📦 构建 Docker 镜像
```bash
# 构建 amd64 镜像
docker build -t frpc-console:amd64 .
# 多架构构建 (需要 buildx)
docker buildx build --platform linux/amd64,linux/arm64 -t frpc-console:latest --push .
```
--- ---
@@ -219,7 +211,7 @@ frpc-console 遵循 **“够用就好”** 的原则:
· ✨ 多平台 frpc 自动适配</br> · ✨ 多平台 frpc 自动适配</br>
· 🐳 Docker 镜像支持 · 🐳 Docker 镜像支持
### .0-Release (正在修整,后续开发) ### 2.0-Release (正在修整,后续开发)
--- ---