diff --git a/install_binary.md b/install_binary.md new file mode 100644 index 0000000..5c4baf9 --- /dev/null +++ b/install_binary.md @@ -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 进程 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`,重新运行。 \ No newline at end of file diff --git a/readme.md b/readme.md index 115982d..0156734 100644 --- a/readme.md +++ b/readme.md @@ -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 自动适配
· 🐳 Docker 镜像支持 -### .0-Release (正在修整,后续开发) +### 2.0-Release (正在修整,后续开发) ---