在线安装 - 1panel 文档 Linux安装步骤详解
详解 1Panel 在 Linux 服务器上的在线安装步骤。涵盖环境检查、SSH 终端操作、官方脚本执行、Docker 依赖处理及浏览器访问配置,助您快速搭建运维管理面板。
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 终端、官方脚本、安装提示、浏览器地址和管理面板逐层确认,就能有效区分“脚本未执行”、“安装未完成”和“面板已安装但端口不可访问”等不同状况。

关于【安装完成后的检查关系】
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
Photoshop 2026 是 Adobe 推出的专业图像处理与视觉设计软件,支持 Windows、macOS 和 iPad 等平台,广泛应用于摄影修图、电商设计、平面海报、数字绘画及视觉合成等创作场景。
Blender 是一款免费开源、跨平台的专业 3D 创作软件,集建模、动画、渲染、视频编辑与视觉合成等功能于一体,广泛应用于影视动画、游戏设计和建筑可视化等领域。软件支持 Cycles 物理渲染器与 Eevee 实时渲染引擎,并提供多边形建模、骨骼绑定、物理模拟等专业工具。Blender 兼容 Windows、macOS 和 Linux 系统,安装包轻巧、运行流畅,依托活跃的全球开发者社区持续更新,是从初学者到专业创作者都值得选择的正版 3D 创作工具。
















