Skip to content

手动运行二进制 ​

适合临时试用、快速验证,或不想注册系统服务时使用。

下载 ​

到仓库 Releases 页面下载对应平台的压缩包:

https://cnb.cool/liumou_site/GoPanel/-/releases

架构压缩包名
x86_64 / amd64GoPanel-linux-amd64.tar.gz
aarch64 / arm64GoPanel-linux-arm64.tar.gz
armv7 / armhfGoPanel-linux-arm-softfloat.tar.gz

也可以直接命令行下载(把 <tag> 换成具体版本号):

bash
curl -fLO https://cnb.cool/liumou_site/GoPanel/-/releases/download/<tag>/GoPanel-linux-amd64.tar.gz
tar -xzf GoPanel-linux-amd64.tar.gz

启动 ​

bash
chmod +x GoPanel-linux-amd64
./GoPanel-linux-amd64

默认监听 12395 端口,浏览器访问 http://localhost:12395/。

默认数据库是 SQLite:不写任何配置也能起服务,数据文件落在工作目录的 data/gopanel.db(首次启动自动创建),无需安装 MySQL / PostgreSQL。

配置文件(可选) ​

宿主机直接部署使用 TOML 格式配置;只在需要改端口或换成 MySQL / PostgreSQL 时才需要:

bash
cp config/config.toml.sample config/config.toml
vim config/config.toml

程序启动时自动识别 config/config.toml;也可以用 -c= / GOPANEL_CONFIG 指定其它路径。 全部参数均可由环境变量提供(GOPANEL_DB_TYPE 未设置时默认 SQLite),配置文件为可选。

常用命令 ​

bash
./GoPanel -version          # 打印版本号后退出
./GoPanel -h                # 帮助
./GoPanel -se               # 打印安全访问入口 URL
./GoPanel -sr               # 重置安全入口随机路径
./GoPanel -rp               # 重置管理员密码(随机值)
./GoPanel -c=config/config.toml   # 指定配置文件

完整参数说明见 命令行参数。

安装向导(命令行方式) ​

首次启动后可以直接在浏览器里走向导,也可以用命令行初始化:

bash
# MySQL
./GoPanel init --user=root --password="root" --host="127.0.0.1:3306" \
  --database=gopanel --adminUser=admin --adminPass="admin123"

# SQLite
./GoPanel init --type=sqlite --database="config/gopanel.db" \
  --adminUser=admin --adminPass="admin123"

后台常驻 ​

二进制内置 systemd 服务管理(基于 glsm v2):-install 注册 gopanel.service 并启动(开机自启),-uninstall 卸载,-service status|start|stop|restart 日常管理; 需要 root 权限(非 root 会明确报错)。

bash
sudo ./GoPanel -install              # 注册服务并启动(ExecStart=当前二进制,WorkingDirectory=其所在目录)
sudo ./GoPanel -service status       # 查看服务状态
sudo ./GoPanel -service restart      # 重启服务
sudo ./GoPanel -uninstall            # 卸载服务(不删程序与数据)

一键脚本 scripts/install.sh -install 下载安装后即调用主程序完成注册 (示例见 一键脚本安装(二进制));也可自行编写 unit, 示例见 手动编写 systemd 服务。

想在任何目录直接敲命令,可加一条软链(脚本安装会自动创建 /usr/bin/gopanel):

bash
sudo ln -sf /opt/gopanel/GoPanel /usr/bin/gopanel   # 之后 gopanel -service status 可直接用

相关 ​

基于 AGPL-3.0 协议发布