2.2 安装后的初始化向导与首次配置

一句话回答

第一次登录面板,核心是做完三件事:把「面板设置」调成你的(界面、超时、告警),挂上一个备份账号并做一次快照,然后按需升级版本。这三件事决定了后面用得顺不顺、出事能不能回滚。

第一次登录:地址与入口

打开浏览器,访问安装时控制台给你的地址:

http://你的服务器IP:面板端口/安全入口

三个常见问题:

现象 原因 解决
网页打不开、转圈 云安全组没放行端口 去云控制台安全组加规则(2.3 节细讲)
打开了但不是登录页 安全入口填错了 地址末尾的安全入口必须和设置的一致
忘了安全入口 当时没记 SSH 上服务器执行 1pctl reset entrance(2.4 节)

输入安装时设置的用户名和密码,进入面板。

面板设置:先认识四个标签页

进入 面板设置,这是整个面板的「总控」。社区版能看到的标签页主要有:面板、安全、面板告警、备份账号、快照、许可证、关于。专业版/企业版会多一些选项(水印、品牌等),企业版普通用户只能看到角色授权过的页面。这节讲和安全无关的三个,安全标签页单独放 2.3 节。

面板:界面与习惯

设置 干什么 建议
主题颜色 亮色 / 暗色 / 跟随系统 看个人喜好
菜单标签页 顶部显示最近访问的标签页 多任务操作时建议开
面板名称 浏览器标题和页面显示名 多台机器时改个有区分度的名字
系统语言 界面语言 中文用户默认即可
超时时间 无操作多久自动退出 建议设短一点(如 30 分钟),安全
默认访问地址 拼接已安装应用的快速访问链接 有域名时填域名
代理服务器 面板部分网络请求走的代理 内网穿墙才需要
菜单设置 控制左侧菜单项显隐 用不到的模块藏起来,界面清爽

一个贴心的设计:个人账号相关的设置(用户名、密码、MFA、通行密钥、API 接口)不在面板设置里,而是迁移到了左下角头像菜单中的「用户信息」。想改密码去那里找,别在面板设置里翻。

面板告警:出事能收到通知

告警渠道官方列了六种:邮箱、企业微信、钉钉、飞书、短信、Bark。先看你能用哪个:

渠道 要不要付费 适合
邮箱 社区版就能用 所有人,配置最简单(SMTP 填一下)
Bark 社区版就能用 iOS 用户,手机推送
企微 / 钉钉 / 飞书 / 短信 专业版或企业版 团队协作

邮箱告警的配置:在【面板设置 → 面板告警】选「邮箱」,填 SMTP 地址(如 smtp.qq.com)、端口(常见 465/587)、发件账号、授权码,设默认收件人,保存后点【发送测试邮件】验证。QQ/163 这类个人邮箱要先在邮箱设置里开启「POP3/SMTP 服务」拿到授权码,填的是授权码不是登录密码。更完整的告警配置在第五章 5.2 节讲,这里先知道「装完顺手配上邮箱告警」就行。

备份账号:给后面所有备份找好去处

备份账号用来存计划任务、应用、网站、数据库和系统快照的备份。官方支持这些:

类型 支持的账号
本地 服务器磁盘
对象存储 阿里云 OSS、腾讯云 COS、亚马逊 S3、MINIO、七牛云 Kodo、又拍云
网盘 微软 OneDrive、谷歌云盘、阿里云盘
其它 WebDAV、SFTP

建议:哪怕只是个人小站,也在初始化时挂一个备份账号(本地磁盘或一个 OSS 都行)。没备份账号 = 快照和计划备份没地方放,等第四章想配自动备份时再回来加也行,但早加早踏实。敏感凭证(密钥、令牌、私钥)按密码管理规范保存,别截图发群里。

快照:装完后必做的「留后路」

快照是 1Panel 的整体回滚手段,备份的是全量数据。官方明确列了快照包含的内容:

内容 路径/位置
Docker 配置文件 /etc/docker/daemon.json
应用商店已装应用 应用商店 → 已安装
本地备份数据 面板设置 → 备份账号
1Panel 产生的数据 整个 [安装目录]/1panel 目录(含数据库文件)
1Panel 二进制文件 /usr/local/bin/1panel
1pctl 命令行工具 /usr/local/bin/1pctl
systemd 服务文件 /etc/systemd/system/1panel.service

使用快照的三条常识:

  1. 创建和同步快照只支持选择第三方账号(不能放本地磁盘),这也是上一节让你先挂备份账号的原因。
  2. 恢复快照前会自动备份当前数据,默认路径是 [安装目录]/original_[快照名]——也就是说恢复失败了还能回滚。
  3. 恢复失败时去 日志审计 → 系统日志 排查原因;机器迁移等场景,把快照放到备份账号对应的指定目录下(服务器磁盘例如 /opt/1panel/backup/system_snapshot/)。

所以初始化的推荐顺序是:挂备份账号 → 创建快照 → 再开始装应用建站。 在「毛坯房」状态下先照个相,后面怎么折腾都不怕。

养成习惯之后,这些时间点都适合补一次快照:

时间点 为什么
初始化完成后 记录「干净」状态,随时能回滚起点
大版本升级前 升级失败概率最高,快照是保命手段
大规模改配置前 比如批量改网站、换数据库参数
装完一组关键应用后 应用连同配置整体留档

快照会占备份空间,但比起「出事没法回滚」,这点空间不值一提。

版本管理:检查更新与升级

面板设置 → 关于 里可以检查新版本。在线升级会替换 1Panel 二进制、1pctl 和 1panel.service,失败自动回滚。许可证 标签页用来查看、导入和管理许可证——导入专业版/企业版许可证后,系统按许可证类型、有效期和节点授权范围开放功能。关于版本怎么选,见第一章 1.2 节。

从社区版升级到企业版

官方提供了迁移工具 1panel-migrator,装好之后一条命令:

1panel-migrator upgrade enterprise

前置条件:把企业版安装包下载到服务器,放在与当前 1Panel 安装目录同级的位置——比如安装目录是 /opt/1panel,安装包就放 /opt/ 下面。之前 1.2 节说过「先社区版、后升级完全可行」,这里给出落点。

三个第一次登录的常见疑问

Q:为什么我登录后面板显示的是英文? A:在 面板设置 → 面板 → 系统语言 里切换。安装时也可以用 PANEL_LANG=zh 指定(2.1 节非交互参数)。

Q:左侧菜单有些模块我用不到,能藏起来吗? A:可以。面板设置 → 面板 → 菜单设置 控制每个菜单项是否显示。比如你只建站不搞 AI,把 AI 相关菜单藏掉,界面立刻清爽。需要的时候随时再开。

Q:面板设置的「开发者模式」是什么? A:官方文档说明,社区版和专业版可以按页面启用预览相关能力(企业版不显示该选项)。新手不用管它,默认关闭即可。

一份「首次登录」的初始化清单

照着做,十五分钟收工:

□ 用 IP:端口/安全入口 登录面板
□ 面板设置 → 面板:改面板名称、设超时时间
□ 左下角头像 → 用户信息:确认用户名密码、开 MFA
□ 面板设置 → 面板告警:配邮箱告警,发一封测试邮件
□ 面板设置 → 备份账号:挂一个备份账号
□ 面板设置 → 快照:创建第一个快照
□ 面板设置 → 关于:检查更新
□ 面板设置 → 安全:端口、安全入口、授权 IP(2.3 节专门讲)

前七件是这一节的内容,最后一件是下一节的主线——安全加固的操作细节比较多,单独成节。

本节要点

  • 第一次登录地址是 http://IP:端口/安全入口,打不开先查云安全组;
  • 改密码去左下角头像 → 用户信息,不在面板设置里;
  • 面板告警:邮箱和 Bark 社区版免费用,企微/钉钉/飞书/短信要付费许可证;
  • 初始化顺序:挂备份账号 → 建快照 → 再开始用;快照是整体回滚手段,恢复前会自动备份当前数据;
  • 社区版升级企业版用 1panel-migrator upgrade enterprise,安装包放在安装目录同级。

备份账号、快照、告警的更细配置说明,可对照《1Panel 官方文档:功能手册》中的「面板设置」一章。

下一步:安全加固——端口、安全入口、SSL、账号,四件事逐项配,配完还要验证。