环境要求
最低要求
| 项目 | 要求 |
|---|---|
| 操作系统 | Linux（amd64 / arm64 / armv7） |
| 内存 | 512 MB 起（SQLite + 轻量使用） |
| 磁盘 | 1 GB 起（含数据库与日志） |
| 数据库 | 无需额外安装：默认 SQLite；如需 MySQL 5.7+ / MariaDB 10.x+ / PostgreSQL 18+ 可自行准备并改配置 |
| 部署方式 | Docker 20.10+ 或直接运行二进制 |
构建环境（只有从源码构建时需要）
| 工具 | 版本 |
|---|---|
| Go | ≥ 1.26 |
| Node.js | ≥ 22 |
| npm / pnpm | npm ≥ 10（仓库同时带 package-lock.json 与 pnpm-lock.yaml） |
后端入口是仓库根 main.go（go build -o GoPanel .），cmd/gopanel 为等价薄壳，完整步骤见 从源码构建。
支持的操作系统与架构
发布二进制按「版本 + 架构」拼接文件名：
| 架构 | 文件名 |
|---|---|
| x86_64 / amd64 | GoPanel-linux-amd64 |
| aarch64 / arm64 | GoPanel-linux-arm64 |
| armv7 / armhf | GoPanel-linux-arm-softfloat |
容器镜像（latest / <tag>）支持 linux/amd64、linux/arm64、linux/arm/v7 多架构； dev 标签为 linux/arm64 单架构（开发自用，生产请用多架构标签）。
端口
| 端口 | 用途 |
|---|---|
12395 | 管理后台（唯一监听端口，可自定义） |
本程序是单一监听端口的管理后台，站点 HTTP/HTTPS 端口由外部 Nginx / Caddy 反代承载， 程序自身不监听这些端口。
权限
宿主机直接部署时建议用 root 或具备相应权限的账号运行， 因为以下功能需要读取系统信息或操作宿主资源：
- 防火墙管理（firewalld / ufw / nftables / iptables）
- SSH 管理（写
authorized_keys、读/var/log/secure） - 端口与进程采集（读
/proc） - 服务管理