Ubuntu服务器安装1Panel面板的完整指南

1. 为什么选择1Panel面板？

1Panel是一款面向Linux服务器的现代化开源管理面板，相比传统面板工具，它采用容器化架构设计，具有以下核心优势：

• 轻量化部署：基于Docker容器运行，不污染系统环境，卸载后不留残余文件
• 可视化操作：提供Web端图形界面，降低服务器管理门槛
• 应用商店：集成主流开发环境、数据库和工具的一键安装
• 安全防护：内置防火墙规则管理、SSL证书自动续签等功能
• 资源监控：实时查看CPU、内存、磁盘等系统资源使用情况

对于Ubuntu用户而言，1Panel特别适合以下场景：

• 刚接触Linux系统的新手管理员
• 需要快速搭建Web开发环境的开发者
• 希望集中管理多个服务的企业用户

2. 安装前的系统准备

2.1 系统要求检查

在开始安装前，请确保您的Ubuntu系统满足以下要求：

通过以下命令检查系统信息：

bash复制# 查看系统版本
lsb_release -a

# 查看系统架构
uname -m

# 查看内存情况
free -h

# 查看磁盘空间
df -h

2.2 环境依赖安装

1Panel需要Docker作为运行环境，执行以下步骤安装依赖：

bash复制# 更新软件包索引
sudo apt update

# 安装必要工具
sudo apt install -y curl wget gnupg software-properties-common

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

# 添加Docker仓库
echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# 安装Docker引擎
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io

# 验证Docker安装
sudo docker run hello-world

注意：如果系统已安装旧版Docker，建议先执行sudo apt remove docker docker-engine docker.io containerd runc进行清理

3. 1Panel核心安装流程

3.1 一键安装脚本执行

官方提供自动化安装脚本，执行以下命令：

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

# 授予执行权限
chmod +x quick_start.sh

# 执行安装
sudo ./quick_start.sh

安装过程会依次完成：

1. 系统环境检测
2. Docker环境检查
3. 1Panel镜像下载
4. 容器服务启动
5. 随机密码生成

3.2 安装后配置

安装完成后会显示访问信息，类似：

code复制1Panel已成功安装！
访问地址: http://<服务器IP>:<端口>
用户名: admin
密码: xxxxxxxx

首次登录需要：

1. 修改默认密码
2. 设置面板访问路径（建议修改默认端口）
3. 配置防火墙放行端口（如有）

4. 常见问题解决方案

4.1 端口冲突处理

如果默认端口(7801)被占用，可通过以下方式解决：

bash复制# 查看端口占用情况
sudo netstat -tunlp | grep 7801

# 方案1：停止占用程序
sudo systemctl stop <服务名>

# 方案2：修改1Panel端口
vim /opt/1panel/conf/app.conf
# 修改server.port后重启
sudo systemctl restart 1panel

4.2 磁盘空间不足

当/var/lib/docker分区空间不足时：

bash复制# 查看Docker存储位置
docker info | grep "Docker Root Dir"

# 方案1：清理无用镜像
docker system prune -a

# 方案2：修改存储路径
sudo systemctl stop docker
sudo rsync -a /var/lib/docker /new/path/
sudo mv /var/lib/docker /var/lib/docker.bak
sudo ln -s /new/path/docker /var/lib/docker
sudo systemctl start docker

4.3 访问问题排查

如果无法访问面板：

1. 检查服务状态：

bash复制sudo systemctl status 1panel

2. 查看日志定位问题：

bash复制journalctl -u 1panel -n 50 --no-pager

3. 常见错误：

• 防火墙未放行端口：sudo ufw allow 7801
• SELinux限制：setenforce 0（临时关闭）

5. 进阶使用技巧

5.1 数据备份与迁移

建议定期备份面板数据：

bash复制# 手动备份
1panel backup --path /backup/1panel

# 自动备份（添加到crontab）
0 3 * * * /usr/local/bin/1panel backup --path /backup/1panel --keep 7

迁移到新服务器时：

1. 在新服务器安装相同版本1Panel
2. 停止两边服务
3. 复制/opt/1panel目录
4. 恢复数据库

5.2 安全加固建议

1. 修改SSH默认端口：

bash复制sudo vim /etc/ssh/sshd_config
# 修改Port后重启
sudo systemctl restart sshd

2. 启用防火墙：

bash复制sudo ufw enable
sudo ufw allow <ssh_port>
sudo ufw allow 7801

3. 配置Fail2Ban防爆破：

bash复制sudo apt install -y fail2ban
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
sudo systemctl restart fail2ban

5.3 性能优化配置

对于高负载场景：

1. 调整Docker资源限制：

bash复制sudo vim /etc/docker/daemon.json
{
  "default-ulimits": {
    "nofile": {
      "Name": "nofile",
      "Hard": 65535,
      "Soft": 65535
    }
  }
}

2. 优化MySQL容器配置：

yaml复制# 在1Panel的MySQL服务配置中添加：
performance_schema=ON
innodb_buffer_pool_size=1G

3. 监控资源使用：

bash复制# 安装htop
sudo apt install -y htop

# 实时监控
htop