在线安装 - 1panel 文档 Linux安装步骤详解

1Panel 是一款运行在 Linux 服务器上的开源运维管理面板。安装完成后，用户可以通过浏览器进入图形化管理界面，便捷地使用应用商店、网站管理、数据库维护以及终端等功能。在线安装过程主要涉及 Linux 终端操作、安装脚本执行、系统交互提示以及最终的浏览器访问。以下将按实际使用顺序，逐一介绍安装过程中需要关注的各个区域和步骤。

关于【Linux 服务器环境】

在开始安装前，首先需要确认服务器运行的是受支持的 Linux 发行版和硬件架构。1Panel 官方支持 Debian、RedHat 系列以及部分国产操作系统，架构方面涵盖 x86_64、aarch64、armv7l 等主流类型。具体支持列表可能随版本更新而变化，建议以当前官方文档为准。

服务器需具备可用的内存、稳定的网络连接以及足够的磁盘空间。安装过程会自动准备面板依赖及容器环境，如果资源过低、磁盘已满或系统软件源不可访问，脚本可能会中途停止。对于正式使用的服务器，建议提前确认数据备份策略和远程登录方式，以防意外情况。

SSH 终端中查看系统环境与磁盘空间

关于【SSH 终端】

在线安装通常在服务器的 SSH 终端中执行。使用终端工具（如 PuTTY、Xshell 或 macOS 终端）登录目标 Linux 主机后，务必确认当前连接的是准备安装 1Panel 的服务器，避免在本地电脑或其他测试机上误执行命令。

由于安装过程涉及系统服务创建、软件包安装和目录权限修改，通常需要使用 root 用户或具有 sudo 权限的账号。登录后，可以先查看系统版本、架构和剩余磁盘空间，再决定采用哪种安装方式。如果没有管理员权限，需联系服务器管理员协助处理。

关于【官方在线安装命令】

1Panel 官网提供的标准在线安装入口是运行 quick_start.sh 脚本。以下是官方示例命令：

bash -c "$(curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh)"

在复制并执行命令前，请务必在 1Panel 官方站点确认当前的下载地址、版本号及适用系统。该命令会从网络获取脚本并在当前服务器直接执行，涉及系统底层配置，切勿替换为来源不明的脚本。在生产环境执行前，建议阅读最新版的安装说明，并准备好回滚或恢复方案。

执行官方 quick_start.sh 安装脚本

关于【终端交互提示】

脚本启动后，会自动检查系统环境，并可能弹出交互提示，要求确认安装、设置访问端口、创建面板管理员账户或填写其他初始化信息。提示内容会随版本迭代有所变化，请严格按照终端当前显示的内容逐项输入，不要机械套用旧教程中的固定选项。

在设置用户名、密码和面板端口时，建议使用强密码并妥善记录。设置的端口不能与服务器上已有的服务冲突；如果使用的是云服务器，还需要在云平台控制台的安全组中放行对应的端口，否则外部无法访问。

关于【依赖和 Docker 环境】

1Panel 的部分在线安装流程会自动准备 Docker 环境或检查其状态。官方文档指出，在某些操作系统上使用在线 Docker 安装脚本时，可能会遇到不支持特定发行版的情况。如果遇到此类提示，应先按照官方建议手动安装并启动 Docker，然后再继续安装 1Panel。

避免在同一台服务器上同时运行多个互相冲突的 Docker 安装脚本。在安装前，先确认 Docker 服务状态、软件源配置和系统初始化方式。需要注意的是，WSL 等特殊环境可能因 systemd 不可用而导致安装失败，不应将其当作普通云服务器直接安装。

关于【安装日志和完成提示】

安装过程中，终端会实时显示下载、解压、服务创建和启动等日志信息。不要仅凭最后一行输出判断成功与否，应仔细检查整个过程中没有出现命令失败、端口占用、服务启动失败或网络超时等错误。

当安装成功时，脚本通常会明确给出面板的访问地址、初始访问方式或后续登录提示。请务必保存这些信息，特别是初次访问的地址、端口和管理员账号。如果终端窗口关闭后找不到这些地址，需要根据当前版本文档或服务器服务配置重新查询。

关于【安装日志和完成提示】

关于【浏览器访问地址】

安装结束后，打开浏览器访问安装脚本提示的 1Panel 地址。该地址通常包含服务器 IP（或域名）和面板端口，必须使用脚本实际输出的值，不要直接照抄其他服务器的示例地址。

首次访问时，浏览器可能会提示证书不安全、端口异常或显示登录页面。先确认地址确实对应自己的服务器，再输入安装期间设置的管理员信息。如果页面打不开，请依次检查服务器上的面板服务状态、云安全组规则、本机防火墙设置以及端口监听状态。

关于【1Panel 管理面板】

成功登录后，即可看到 1Panel 的管理界面。左侧菜单通常用于进入应用商店、网站管理、数据库、容器、终端和系统设置等功能区域。不同版本的菜单名称、排序和权限显示可能略有不同，请以当前页面实际显示为准。

初次进入时，建议先确认当前节点信息、用户权限和系统整体状态。普通用户能否看到或操作某些页面取决于角色权限设置；不要因为某个菜单未显示就判断安装不完整，这通常是权限控制的结果。

关于【网络和端口区域】

在线安装同时依赖服务器访问官方资源（下载脚本和依赖）以及浏览器访问面板（管理操作）。如果脚本下载失败，重点检查 DNS 解析、出网权限、代理设置和系统软件源；如果面板安装成功但浏览器无法打开，重点检查面板端口、云安全组、防火墙规则和服务运行状态。

如果安装命令被安全策略拦截，不要随意关闭全部防火墙。应根据实际使用的端口添加最小范围的放行规则，确认访问正常后，再考虑是否需要启用 HTTPS 或配置反向代理以提升安全性。

关于【网络和端口区域】

关于【离线安装入口】

对于没有外网连接、需要在内网部署或在线脚本不适用的场景，可以查看 1Panel 官方的离线安装文档。离线安装通常需要先下载与服务器架构匹配的安装包，上传到目标主机，解压后执行安装脚本。

在线安装和离线安装并非同一条命令的简单替换。离线包的文件名、架构和版本必须与服务器环境严格对应，安装完成后的访问地址和初始化步骤仍要以脚本实际提示为准。

关于【安装完成后的检查关系】

安装结束后，建议依次进行以下检查：SSH 终端中没有未处理的错误报错，1Panel 服务已正常启动，安装提示的端口能够被访问，浏览器可以打开登录页，管理员账号能正常登录，且左侧菜单和当前用户权限符合预期。

在后续安装应用前，先确认面板和 Docker 状态正常，并做好服务器快照或重要数据备份。通过 Linux 环境、SSH 终端、官方脚本、安装提示、浏览器地址和管理面板逐层确认，就能有效区分“脚本未执行”、“安装未完成”和“面板已安装但端口不可访问”等不同状况。

关于【安装完成后的检查关系】