1Panel 面板安装与卸载教程

2020-03-10 Linux 运维

前言

1Panel 是新一代开源 Linux 服务器运维管理面板,由 Fit2Cloud(飞致云)团队开发。相比传统面板,1Panel 具有现代化 Web UI、容器化应用管理、基于 Docker 的应用部署等特色功能。本文将详细介绍 1Panel 的安装、配置、端口修改、防火墙设置以及卸载方法。

1. 1Panel 简介

1.1 核心特性

特性 说明
现代化 UI 基于 React 的响应式界面
容器化应用 基于 Docker 的一键应用部署
主机管理 监控、文件管理、终端、计划任务
网站管理 支持 LNMP、SSL、反向代理
应用商店 一键部署常用开源应用
开源免费 GPL v3 开源协议

1.2 支持的操作系统

  • Ubuntu 22.04 / 20.04 / 18.04
  • Debian 11 / 12
  • CentOS 7 / 8 Stream
  • Rocky Linux 8 / 9
  • AlmaLinux 8 / 9
  • openSUSE 15.4+

1.3 1Panel vs 宝塔面板

对比项 1Panel 宝塔面板
开源 完全开源 部分闭源
架构 容器化优先 传统 LNMP
UI 设计 现代化 传统风格
应用部署 Docker 应用商店 编译/包管理
资源占用 较低 较高
中文支持 完整 完整

2. 安装前准备

2.1 系统要求

项目 最低要求 推荐配置
CPU 1核 2核+
内存 1GB 2GB+
磁盘 10GB 20GB+
网络 能访问互联网 能访问互联网

2.2 安装 Docker

1Panel 依赖 Docker,需要先安装 Docker:

# 使用官方安装脚本安装 Docker(推荐)
curl -fsSL https://get.docker.com | bash -s docker

# 或使用国内镜像加速
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun

# 启动 Docker 并设置开机自启
systemctl start docker
systemctl enable docker

# 验证 Docker 安装
docker --version
docker ps

2.3 配置 Docker 镜像加速(可选但推荐)

# 创建 Docker 配置目录
mkdir -p /etc/docker

# 配置镜像加速器
cat > /etc/docker/daemon.json <<EOF
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://mirror.ccs.tencentyun.com"
  ]
}
EOF

# 重启 Docker
systemctl daemon-reload
systemctl restart docker

# 验证配置
docker info | grep -A 5 "Registry Mirrors"

3. 安装 1Panel

3.1 官方一键安装脚本

# 使用 curl 执行官方安装脚本
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

或使用 wget:

wget -q https://resource.fit2cloud.com/1panel/package/quick_start.sh -O quick_start.sh && bash quick_start.sh

3.2 安装过程详解

执行安装脚本后,会出现交互式提示:

===============================================
1Panel 安装向导
===============================================
请选择安装方式:
  1. 快速安装(推荐)
  2. 自定义安装
请输入序号 [1-2]: 1

正在检查系统环境...
正在安装 1Panel...

===============================================
安装完成!
===============================================
面板地址: http://192.168.1.100:22222
面板用户: admin
面板密码: xxxxxx
请立即保存以上信息!
===============================================

3.3 自定义安装选项

如需自定义安装路径、端口等,使用自定义安装:

# 下载安装脚本
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh

# 查看帮助
bash quick_start.sh --help

# 自定义参数安装示例
bash quick_start.sh \
  --port 33333 \
  --security-entrance myadmin \
  --install-dir /opt/1panel

3.4 离线安装

对于内网环境,可以使用离线安装包:

# 在有网络的机器上下载离线包
wget https://github.com/1Panel-dev/1Panel/releases/latest/download/1panel-v1.x.x-linux-amd64.tar.gz

# 传输到目标服务器后解压安装
tar -zxvf 1panel-v1.x.x-linux-amd64.tar.gz
cd 1panel-v1.x.x-linux-amd64
bash install.sh

3.5 验证安装

# 检查 1Panel 服务状态
systemctl status 1panel

# 检查 1Panel 版本
1panel --version

# 查看 1Panel 信息
1panel info

# 检查端口监听
ss -tlnp | grep 22222

4. 修改 1Panel 端口

默认端口为 22222,建议修改为非常规端口:

4.1 使用命令行修改

# 查看当前配置
1panel config show

# 修改端口
1panel config set --port 28888

# 重启服务生效
systemctl restart 1panel

# 验证新端口
ss -tlnp | grep 28888

4.2 在 Web 界面修改

  1. 登录 1Panel 面板
  2. 进入 面板设置 → 安全
  3. 修改 面板端口
  4. 点击 保存 并重启面板

5. 防火墙配置

5.1 firewalld(CentOS/Rocky/AlmaLinux)

# 放行 1Panel 端口(以 22222 为例)
firewall-cmd --permanent --add-port=22222/tcp
firewall-cmd --reload

# 验证规则
firewall-cmd --list-ports

# 如需要,同时放行 HTTP/HTTPS
firewall-cmd --permanent --add-service=http
firewall-cmd --permanent --add-service=https
firewall-cmd --reload

5.2 ufw(Ubuntu/Debian)

# 放行 1Panel 端口
ufw allow 22222/tcp
ufw reload

# 查看规则
ufw status

# 放行 HTTP/HTTPS
ufw allow 80/tcp
ufw allow 443/tcp
ufw reload

5.3 云服务器安全组

如果使用阿里云、腾讯云、AWS 等云服务器,还需在安全组中放行对应端口:

端口 协议 说明
22222 TCP 1Panel 面板端口
80 TCP HTTP
443 TCP HTTPS
22 TCP SSH

6. 1Panel 基本配置

6.1 首次登录

  1. 浏览器访问 http://服务器IP:22222
  2. 输入安装时显示的账号密码
  3. 首次登录强制修改密码
  4. 进入面板主页

6.2 安全设置

# 修改安全入口(URL 后缀)
1panel config set --security-entrance mysecret

# 修改后访问地址变为:http://IP:端口/mysecret
# 重启生效
systemctl restart 1panel

在 Web 界面进行更多安全配置:

  • 面板设置 → 安全 → 开启 IP 白名单
  • 面板设置 → 安全 → 开启 两步验证
  • 面板设置 → 安全 → 设置 会话超时

6.3 配置域名访问

如需通过域名访问面板:

  1. 在 DNS 服务商添加 A 记录指向服务器 IP
  2. 在 面板设置 → 安全 → 域名绑定 中添加域名
  3. 配置反向代理或直接使用域名 + 端口访问

6.4 开启 HTTPS

  1. 进入 面板设置 → 安全
  2. 点击 SSL 证书 → 申请证书
  3. 输入域名,自动申请 Let's Encrypt 证书
  4. 开启后访问 https://域名:端口

7. 1Panel 常用功能

7.1 主机监控

1Panel 提供实时主机监控:

  • CPU / 内存 / 磁盘 / 网络使用率
  • 系统负载
  • 进程管理
  • 实时查看系统状态

7.2 应用商店

1Panel 应用商店提供一键部署:

应用类型 示例应用
Web 服务器 Nginx, OpenResty
数据库 MySQL, PostgreSQL, Redis, MongoDB
论坛博客 WordPress, Halo, Typecho
开发工具 GitLab, Jenkins, Gitea
文件管理 FileBrowser, Nextcloud

7.3 容器管理

  • 查看运行中的容器
  • 创建 / 启动 / 停止 / 删除容器
  • 查看容器日志
  • 进入容器终端
  • 管理 Docker 镜像

7.4 网站管理

  • 创建网站(支持静态、PHP、反向代理)
  • 配置 SSL 证书(Let's Encrypt 自动续期)
  • 配置反向代理
  • 设置访问限制和重定向

7.5 文件管理

内置 Web 文件管理器:

  • 上传 / 下载文件
  • 在线编辑文本文件
  • 文件压缩 / 解压
  • 权限管理

7.6 计划任务

支持多种计划任务:

  • Shell 脚本执行
  • 网站备份
  • 数据库备份
  • 容器备份
  • 系统快照

8. 卸载 1Panel

8.1 使用官方卸载脚本

# 下载卸载脚本
curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh

# 执行卸载
bash quick_start.sh uninstall

8.2 手动卸载步骤

如需完全手动卸载:

# 1. 停止 1Panel 服务
systemctl stop 1panel
systemctl disable 1panel

# 2. 删除 1Panel 程序文件
rm -rf /opt/1panel
rm -rf /usr/local/bin/1panel

# 3. 删除 1Panel 数据目录(默认在 /opt/1panel)
# 注意:删除数据目录会丢失所有面板配置和应用数据
rm -rf /opt/1panel/data

# 4. 删除 systemd 服务文件
rm -f /etc/systemd/system/1panel.service
systemctl daemon-reload

# 5. 清理 1Panel 创建的容器和网络(可选)
# 注意:这将删除 1Panel 管理的所有容器
docker rm -f $(docker ps -aq --filter "label=1panel")
docker network rm 1panel-network

# 6. 删除 1Panel 用户(如有)
userdel -r 1panel 2>/dev/null

8.3 保留数据卸载

如果只想卸载面板程序但保留数据:

# 停止服务
systemctl stop 1panel
systemctl disable 1panel

# 只删除程序,保留 /opt/1panel 数据目录
rm -rf /opt/1panel/*
# 但保留以下目录
mkdir -p /opt/1panel/data
mkdir -p /opt/1panel/backup

9. 常用 1Panel 命令

1Panel 提供了命令行工具,常用命令如下:

# 查看帮助
1panel --help

# 查看面板信息(地址、账号、密码)
1panel info

# 启动/停止/重启面板
1panel start
1panel stop
1panel restart

# 查看面板状态
1panel status

# 修改密码
1panel passwd

# 查看配置
1panel config show

# 修改配置
1panel config set --port 22222
1panel config set --security-entrance myadmin

# 更新 1Panel
1panel update

# 卸载
1panel uninstall

10. 常见问题排查

10.1 无法访问面板

# 检查服务状态
systemctl status 1panel

# 检查端口监听
ss -tlnp | grep 22222

# 检查防火墙
firewall-cmd --list-ports   # CentOS
ufw status                  # Ubuntu

# 查看面板日志
journalctl -u 1panel -f

10.2 忘记密码

# 使用命令行重置密码
1panel passwd

# 按照提示输入新密码

10.3 面板启动失败

# 查看详细错误日志
journalctl -u 1panel -n 50 --no-pager

# 检查端口是否被占用
ss -tlnp | grep 22222

# 如端口冲突,修改端口
1panel config set --port 28888
systemctl restart 1panel

10.4 Docker 相关错误

# 检查 Docker 服务
systemctl status docker

# 重启 Docker
systemctl restart docker

# 检查 Docker 镜像是否正常
docker images

# 重新安装 1Panel 的 Docker 依赖
1panel update --docker

11. 总结

1Panel 是一款现代化的开源服务器运维面板,特别适合:

  • 需要容器化应用管理的场景
  • 喜欢现代化 UI 的用户
  • 需要快速部署开源应用的场景

本文详细介绍了:

  1. 安装:一键脚本安装,3 分钟完成
  2. 配置:端口修改、防火墙、安全设置
  3. 功能:主机监控、应用商店、容器管理、网站管理
  4. 卸载:官方脚本和手动卸载两种方式
  5. 排查:常见问题及解决方法

使用建议:

  • 生产环境务必修改默认端口和安全入口
  • 开启两步验证增强安全性
  • 定期备份面板数据和网站数据
  • 关注 1Panel GitHub 获取最新更新和安全公告