常见问题
安装
Q：可以不装数据库直接用吗？ A：可以。选 SQLite（个人使用 / 测试），数据文件落在 config/ 目录，升级前记得备份该目录。
Q：默认端口是多少？能改吗？ A：默认 12395。用 GOPANEL_PORT 环境变量或配置文件 server.port 修改。
Q：需要额外配置站点端口吗？ A：不需要，也不支持。程序是单一监听端口的管理后台，站点 / HTTPS 由外部 Nginx / Caddy 反代承载。
Q：arm64 机器能用吗？ A：可以。二进制发布覆盖 amd64 / arm64 / armv7（见仓库 Releases 页面的 GoPanel-linux-<arch> 附件）。
登录与账号
Q：能注册账号吗？ A：不能。系统不提供注册功能，账号由管理员在后台创建。
Q：忘记管理员密码怎么办？ A：./GoPanel -rp。详见 安装向导与账号。
Q：忘记安全入口（随机登录路径）怎么办？ A：./GoPanel -se 打印，./GoPanel -sr 重置并打印新地址。
Q：登录提示 429？ A：触发了登录失败锁定（默认 3 次失败锁 5 分钟），到「设置 → IP 黑名单」解锁。
功能
Q：面板能管理系统上的 Caddy / Nginx 吗？ A：能。站点服务以 Caddy 为内核，配置与二进制路径可在「设置 → 服务路径」调整。
Q：容器里为什么看不到宿主机的端口和进程？ A：面板只支持二进制宿主机安装，直接运行在宿主机上即可看到全部端口与进程。
Q：容器导出的 compose 能直接用吗？ A：编排创建的容器导出的是完整原始 yml，可直接 docker compose up -d； 独立容器是按 docker inspect 反推的，包内会标注「需人工确认」项。
Q：应用商店的应用带安装脚本吗？ A：不带。安装与卸载由面板原生执行（docker compose up -d / down），数据卷默认保留。
运维
Q：如何升级？ A：重新执行安装脚本或替换二进制文件即可。详见 升级与备份。
Q：主密钥是干什么的？必须备份吗？ A：用于加密堡垒机凭据、DNS 账号密钥与安全码。必须备份，与数据库配套；换了密钥旧密文全部失效。
Q：日志在哪儿？ A：data/logs/（可用 GOPANEL_LOG_DIR 修改），systemd 部署也可用 journalctl -u gopanel 查看。
Q：数据存在哪里？ A：数据库 + config/（配置、SQLite 文件、master.key）+ data/（日志、证书私钥）。