🎉 拥抱现代化运维,GoPanel强势来袭! 查看详情 →
使用帮助

GoPanel 简明使用指南

面向真实使用场景的快速上手:安装、访问、网站与证书、容器与数据库、流水线与协作、AI 助手、常见问题排查。

快速开始

目标:从一台新机器开始,在几分钟内安装并打开 GoPanel。

1
准备服务器
推荐使用具备公网访问能力的服务器或虚拟机;确保开放面板端口(具体端口以安装输出为准),并准备好可登录的系统账户(Linux 通常为 root 或具备 sudo 权限的用户)。
2
运行安装命令
在服务器终端执行以下命令完成安装与初始化:
bash
$ curl -sSL https://gopanel.run | bash
安装过程会输出访问地址与初始账号信息。建议保留日志或截图保存。
3
打开面板
在浏览器中访问安装输出的地址,完成首次登录后即可开始管理网站、证书、容器、数据库、流水线等功能。

首次登录与安全建议

先把安全底线打好,后面会省掉大量排障成本。

修改初始密码
首次登录后立即修改管理员密码,并确保使用强密码(长度、复杂度、唯一性)。
开启 HTTPS
推荐为面板入口绑定域名并开启 HTTPS,避免明文登录与会话劫持风险。
最小权限协作
团队多人使用时,为每位成员创建独立账号并分配最小权限,避免共享管理员账号。
配置备份策略
对关键配置与数据库建立定期备份与保留策略,重大变更前手动做一次快照。

常用功能(怎么用更顺)

下列是最典型的使用路径,适合第一次上手按步骤照做。

网站与域名:从 0 到上线

1) 添加站点:选择域名与站点目录或应用部署方式。

2) 配置反向代理:将域名指向你的应用端口或容器服务。

3) 开启 HTTPS:申请证书并配置自动续期。

4) 验证上线:检查 DNS、端口、证书链与访问日志。

SSL 证书:申请与自动续签

确保证书申请前域名解析已生效,且验证方式(HTTP/DNS)可通过。

建议:为关键业务域名启用自动续签,并关注续签失败通知。

容器与应用:快速部署常用服务

优先使用“应用商店/模板”部署数据库、缓存、消息队列等常见组件。

部署后检查:端口映射、数据卷挂载、环境变量、健康检查与日志。

数据库:创建、授权与备份

生产环境建议:单独账号、最小权限、定期备份、可用性监控。

变更建议:先备份再改结构,关键操作留存审计记录。

流水线(CI/CD):把发布流程固化下来

推荐流程:拉代码 → 构建 → 测试 → 打包 → 部署 → 健康检查 → 可选回滚。

把“环境变量/密钥/凭证”放到安全配置里统一管理,不要写进仓库。

AI 助手:怎么问更有效

AI 的价值不只是回答问题,更是把“排障思路 + 可执行动作”串起来。

推荐提问方式

把目标、当前现象、关键日志三件事说清楚:

“我在部署 Nginx 反代到 3000 端口,访问 502;请根据日志给出排查顺序,并告诉我每一步该看什么。”

把动作变成模板

建议把常用流程固化成团队模板:

例如:证书续签失败排查、容器升级回滚、数据库备份恢复演练。

团队协作:推荐的最小闭环

从“一个人能用”到“团队可靠地用”,差别在规范与权限。

权限与审计
管理员只做“授权与策略”;日常操作尽量由成员的个人账号完成,所有关键动作可追溯。
发布规范
通过流水线发布,避免手工登录服务器改配置;对生产环境变更执行“备份 → 变更 → 验证 → 回滚预案”。

常见问题(先看这里)

遇到问题时,优先按“网络 → 端口 → 服务状态 → 日志”顺序排查。

打不开面板(连接超时/拒绝连接)

1) 检查服务器安全组/防火墙是否放行端口。

2) 检查面板服务是否运行,必要时重启服务。

3) 若使用反向代理,确认上游端口与健康状态正常。

证书申请失败

常见原因:DNS 未生效、80/443 未开放、验证路径被拦截、代理规则冲突。

建议:先用浏览器访问验证路径确认可达,再重试申请。

部署后 502/404

502:上游服务未启动/端口不通/容器健康检查失败。

404:路由规则不匹配或站点根目录设置不正确。