1Panel 安装与使用详细教程

现代化 Linux 服务器运维管理面板 · Modern Linux Server Management Panel

一、1Panel 简介

1.1 什么是 1Panel

1Panel 是一款现代化、开源的 Linux 服务器运维管理面板，由 FIT2CLOUD 飞致云 开发和维护。它提供了直观的 Web 界面，让用户可以轻松管理服务器、部署网站、管理数据库、运行 Docker 容器等。

1.2 核心特性

• 🎨 现代化界面：基于 Vue 3 + TypeScript 开发，界面美观流畅
• 🐳 容器化管理：基于 Docker，所有应用运行在容器中
• 🌐 多语言支持：内置中文、英文等多种语言
• 🔒 安全可靠：支持 HTTPS、面板安全入口、IP 白名单等
• 📦 应用商店：内置丰富的应用，一键安装 WordPress、Typecho 等
• 💾 自动备份：支持定时备份到本地、S3、OSS 等多种存储
• 📊 实时监控：CPU、内存、网络、磁盘等实时监控

1.3 适用场景

• 个人博客、网站服务器管理
• 中小企业应用部署与运维
• 开发测试环境管理
• 学习 Linux 和 Docker 的可视化工具

二、安装前准备

2.1 系统要求

操作系统	架构	最低版本
Ubuntu	amd64 / arm64	20.04+
Debian	amd64 / arm64	11+
CentOS	amd64 / arm64	7.9+
Rocky Linux	amd64 / arm64	8.0+
openEuler	amd64 / arm64	22.03+

2.2 硬件要求

配置项	最低要求	推荐配置
CPU	1 Core	2 Cores+
内存	1 GB	2 GB+
硬盘	20 GB	40 GB SSD+

2.3 SSH 工具

• Windows：FinalShell / Xshell / PuTTY / Windows Terminal
• macOS / Linux：系统自带 Terminal

三、安装 1Panel

3.1 一键在线安装（推荐）

使用官方一键安装脚本，适用于 Ubuntu / Debian / CentOS / Rocky / openEuler：

curl -sSL https://resource.fit2cloud.com/1panel/package/quick_start.sh -o quick_start.sh && bash quick_start.sh

3.2 Ubuntu / Debian 手动安装

# 更新系统
apt update && apt upgrade -y

# 安装依赖
apt install -y curl wget

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

3.3 CentOS / Rocky Linux 手动安装

# 更新系统
yum update -y

# 安装依赖
yum install -y curl wget

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

3.4 Docker 方式安装（高级用户）

如果服务器已有 Docker 环境，可使用 Docker 安装：

docker run -d \
  --name 1panel \
  --restart always \
  --network host \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /opt/1panel:/opt/1panel \
  -v /root/.1panel:/root/.1panel \
  moelin/1panel:latest

3.5 安装过程说明

安装过程中需要设置：

1. 面板端口（默认 20234，建议修改）
2. 面板用户名和密码
3. 面板安全入口（URL 路径前缀，增强安全性）
4. 安装目录（默认 /opt）

四、初始配置

4.1 访问面板

安装完成后，浏览器访问（替换为你的服务器 IP 和安全入口）：

http://your_server_ip:panel_port/security_entry

4.2 登录面板

使用安装时设置的用户名和密码登录。

4.3 修改面板设置

登录后进入「面板设置」：

• 修改端口：面板设置 → 端口 → 修改
• 修改安全入口：面板设置 → 安全入口 → 修改
• 修改密码：面板设置 → 账户密码 → 修改
• 面板 SSL：面板设置 → 面板 SSL → 启用

4.4 配置防火墙

在 1Panel 面板中：「主机」→「防火墙」中放行面板端口：

# 命令行放行（如果使用 ufw）
ufw allow 20234/tcp

# 命令行放行（如果使用 firewalld）
firewall-cmd --permanent --add-port=20234/tcp
firewall-cmd --reload

五、面板功能详解

5.1 概览

首页显示：

• 系统信息（操作系统、CPU、内存、磁盘）
• 实时监控图表（CPU、内存、网络、磁盘 IO）
• 快速入口（网站、数据库、容器等）
• 系统通知和告警

5.2 网站管理

「网站」菜单可以：

• 创建 PHP / 静态 / 反向代理网站
• 配置域名、SSL 证书
• 设置反向代理（类似 Nginx Proxy Manager）
• 管理网站日志和资源限制

5.3 数据库管理

「数据库」菜单支持：

• MySQL / MariaDB / PostgreSQL 一键安装
• 创建和管理数据库
• 数据库用户权限管理
• 导入导出和远程访问设置

5.4 容器管理

「容器」菜单提供：

• 查看运行中的容器
• 启动 / 停止 / 重启 / 删除容器
• 查看容器日志和资源占用
• 进入容器终端（Web 终端）

5.5 应用商店

「应用商店」是一大亮点，内置丰富的开源应用：

分类	应用示例
博客/CMS	WordPress、Typecho、Halo、Hexo
知识库	Wiki.js、BookStack、Outline
数据库	MySQL、PostgreSQL、Redis、MongoDB
运维工具	Portainer、phpMyAdmin、Adminer
媒体	Jellyfin、qBittorrent、Transmission

5.6 计划任务

「计划任务」支持：

• Shell 脚本定时执行
• 网站备份
• 数据库备份
• 日志清理
• 证书续期

5.7 主机防火墙

图形化管理防火墙规则：

• 添加 / 删除端口规则
• IP 白名单 / 黑名单
• 导入 / 导出规则

5.8 SSH 管理

通过面板修改 SSH 配置：

• 修改 SSH 端口
• 禁用 root 登录
• 密钥认证
• IP 白名单

六、网站部署实战

6.1 部署静态网站

在「网站」→「创建网站」中：

1. 选择「静态网站」
2. 填写主域名（如 example.com）
3. 选择协议（HTTP / HTTPS）
4. 上传网站文件到网站目录

6.2 一键部署 WordPress

通过应用商店部署：

1. 「应用商店」→ 搜索 WordPress → 点击「安装」
2. 填写域名、端口、数据库信息
3. 等待安装完成，访问域名即可

6.3 配置 SSL 证书

「网站」→ 选择网站 → 「设置」→ 「HTTPS」：

• 自签证书：临时使用，浏览器会提示不安全
• Let’s Encrypt：免费自动续期，需要域名解析正确
• 手动上传：上传自己的证书文件

6.4 反向代理配置

将域名代理到内网服务（如 Docker 应用）：

1. 「网站」→「创建网站」→「反向代理」
2. 填写域名
3. 代理地址：http://127.0.0.1:容器端口
4. 保存后即可通过域名访问容器服务

七、容器管理

7.1 容器列表

「容器」页面显示所有 Docker 容器，可以进行：

• 查看容器状态（运行中 / 已停止）
• 启动 / 停止 / 重启 / 删除
• 查看实时资源占用（CPU、内存、网络）
• 查看容器日志
• 进入 Web 终端

7.2 镜像管理

「镜像」页面支持：

• 拉取镜像（从 Docker Hub、镜像加速器）
• 查看本地镜像列表
• 删除未使用的镜像
• 导入 / 导出镜像

7.3 容器编排

通过 docker-compose.yml 创建复杂应用：

version: '3.8'
services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"
    volumes:
      - ./html:/usr/share/nginx/html
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: your_password
    volumes:
      - db_data:/var/lib/mysql
volumes:
  db_data:

7.4 常用 Docker 命令

# 查看运行中的容器
docker ps

# 查看所有容器
docker ps -a

# 查看容器日志
docker logs -f container_name

# 进入容器
docker exec -it container_name bash

# 查看资源占用
docker stats

# 清理未使用资源
docker system prune -a

八、备份与恢复

8.1 创建备份账号

「设置」→「备份账号」中可以添加多种备份目的地：

• 本地存储：备份到服务器本地
• S3 兼容存储：AWS S3、MinIO、阿里云 OSS、腾讯云 COS
• WebDAV：坚果云、Nextcloud 等
• SFTP：备份到另一台服务器

8.2 计划备份

「计划任务」→「创建任务」：

1. 任务类型：网站备份 / 数据库备份 / 目录备份
2. 选择备份对象
3. 选择备份账号
4. 设置 cron 表达式（如每天凌晨 3 点：0 3 * * *）
5. 设置保留份数（如保留 7 天）

8.3 手动备份与恢复

「备份」页面可以查看所有备份记录，支持：

• 查看备份详情
• 下载备份到本地
• 从备份恢复
• 删除备份

8.4 跨服务器迁移

使用 1Panel 迁移功能：

1. 源服务器：「设置」→「面板迁移」→ 生成迁移数据
2. 目标服务器：安装 1Panel 后选择「从其他面板迁移」
3. 输入迁移数据完成迁移

九、常用管理命令

9.1 1Panel 服务管理

# 查看服务状态
systemctl status 1panel

# 启动服务
systemctl start 1panel

# 停止服务
systemctl stop 1panel

# 重启服务
systemctl restart 1panel

# 设置开机自启
systemctl enable 1panel

# 查看面板信息（地址、用户名、密码）
1pctl user-info

# 重置面板密码
1pctl reset password

# 卸载 1Panel
1pctl uninstall

9.2 系统监控命令

# 实时系统监控
top
htop

# 磁盘使用
df -h
du -sh /*

# 内存使用
free -h

# 网络连接
ss -tulnp
netstat -tulnp

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

9.3 故障排除

Q1：无法访问面板

• 检查服务状态：systemctl status 1panel
• 检查防火墙和安全组规则
• 检查服务器 IP 和端口是否正确
• 查看日志：journalctl -u 1panel -n 50

Q2：忘记面板密码

1pctl reset password

Q3：忘记安全入口

1pctl reset entrance

Q4：Docker 服务异常

# 重启 Docker
systemctl restart docker

# 查看 Docker 状态
systemctl status docker

# 重启 1Panel
systemctl restart 1panel