1panel 服务器面板安装详解 – wiki大全

作者： /

1Panel 服务器面板安装详解

前言

1Panel 是一个现代化、高效、安全的 Linux 服务器运维管理面板。它提供了可视化的界面，让用户可以轻松管理服务器上的网站、数据库、容器等应用。无论您是经验丰富的运维人员还是初学者，1Panel 都能大大简化服务器管理工作。本文将详细介绍 1Panel 的安装过程，帮助您快速上手。

准备工作

在安装 1Panel 之前，请确保您的服务器满足以下条件：

  1. 操作系统：支持主流的 Linux 发行版，如 CentOS 7/8/9+, Ubuntu 18.04/20.04/22.04+, Debian 10/11/12+。建议使用纯净的操作系统，以避免潜在的兼容性问题。
  2. 硬件要求：
    • CPU：1 核或以上
    • 内存：1GB 或以上（建议 2GB 或以上，特别是当您计划运行多个应用或数据库时）
    • 硬盘：10GB 或以上可用空间
  3. 网络连接：服务器需要有稳定的网络连接，以便下载安装包和后续的应用部署。
  4. 开放端口：
    • 1Panel 默认管理端口为 20000。您需要在防火墙（包括服务器内部防火墙和云服务商的安全组）中开放此端口。
    • 如果您计划部署网站，还需要开放 80 (HTTP) 和 443 (HTTPS) 端口。
    • 其他应用（如数据库、FTP）可能需要开放额外的端口。
  5. SSH 客户端：您需要一个 SSH 客户端（如 PuTTY、Xshell、macOS/Linux 自带终端）来连接到您的服务器。
  6. root 权限：安装过程需要 root 用户权限或具有 sudo 权限的用户。

1Panel 安装步骤

1Panel 提供了两种主要的安装方式：一键安装脚本和手动安装 Docker + 1Panel。一键安装脚本是最推荐和最简单的方式。

方法一：使用一键安装脚本 (推荐)

这是最简单、最快捷的安装方式。一键脚本会自动检测您的系统环境，安装 Docker 及其依赖，然后部署 1Panel。

1. 连接到服务器

使用 SSH 客户端连接到您的 Linux 服务器。例如：

bash
ssh root@your_server_ip

请将 your_server_ip 替换为您的服务器实际 IP 地址。

2. 执行安装脚本

在连接到服务器后，执行以下命令：

bash
curl -sSL https://resource.fit2cloud.com/1panel/bash/install.sh | bash

  • curl -sSL https://resource.fit2cloud.com/1panel/bash/install.sh：这会从 1Panel 官方资源站下载安装脚本。
    • -s：静默模式，不显示进度或错误消息。
    • -S：即使在静默模式下也显示错误。
    • -L：如果遇到 HTTP 重定向，curl 将会跟随重定向。
  • | bash：将下载的脚本内容通过管道符传递给 bash 命令执行。

3. 等待安装完成

脚本执行后，您会看到安装过程的输出。脚本会自动完成以下任务：

  • 检查操作系统兼容性。
  • 安装或更新 Docker。
  • 下载并部署 1Panel 相关的 Docker 镜像和容器。
  • 配置 1Panel 运行环境。
  • 生成 1Panel 面板的访问地址、用户名和密码。

整个过程可能需要几分钟，具体取决于您的服务器性能和网络速度。

4. 记录面板信息

安装成功后，脚本会在最后输出 1Panel 的访问地址（URL）、用户名（username）和密码（password）。请务必将这些信息复制并妥善保存。

示例输出：

“`
…
Install 1Panel successful!

1Panel login information:

URL: http://your_server_ip:20000/
Username: 1panel
Password: your_generated_password

Please make sure the port 20000 is open in your firewall.
“`

方法二：手动安装 Docker + 1Panel

如果您希望手动控制 Docker 的安装，或者一键脚本遇到问题，可以尝试这种方式。

1. 连接到服务器

同上，使用 SSH 客户端连接到您的 Linux 服务器。

2. 安装 Docker

请根据您的 Linux 发行版选择合适的 Docker 安装方式。以下是主流发行版推荐的安装命令：

a. CentOS/RHEL/Fedora:

bash
sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo
sudo yum install -y docker-ce docker-ce-cli containerd.io
sudo systemctl start docker
sudo systemctl enable docker

b. Ubuntu/Debian:

bash
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg
echo \
"deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
"$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
sudo systemctl start docker
sudo systemctl enable docker

安装完成后，可以通过 docker run hello-world 命令验证 Docker 是否正常运行。

3. 部署 1Panel 容器

Docker 安装完成后，执行以下命令来部署 1Panel：

bash
docker run -d --restart=always \
--network=host \
--name 1panel \
-v /opt/1panel:/opt/1panel \
-v /var/run/docker.sock:/var/run/docker.sock \
-e PUID=$(id -u) -e PGID=$(id -g) \
--privileged \
1panel/1panel:latest

  • -d：后台运行容器。
  • --restart=always：设置容器在退出时总是自动重启。
  • --network=host：使用宿主机的网络模式，这样 1Panel 可以直接使用宿主机的端口，简化网络配置。
  • --name 1panel：给容器命名为 1panel。
  • -v /opt/1panel:/opt/1panel：将宿主机的 /opt/1panel 目录挂载到容器的 /opt/1panel 目录，用于持久化 1Panel 的数据。
  • -v /var/run/docker.sock:/var/run/docker.sock：将宿主机的 Docker Socket 挂载到容器内，允许 1Panel 通过 Docker API 管理宿主机上的 Docker 容器。
  • -e PUID=$(id -u) -e PGID=$(id -g)：设置容器内部运行用户的 UID 和 GID，通常用于解决文件权限问题。
  • --privileged：赋予容器特权模式，某些应用可能需要。
  • 1panel/1panel:latest：指定使用的 Docker 镜像。

4. 获取 1Panel 登录信息

手动部署后，您需要执行以下命令来获取 1Panel 的登录信息：

bash
docker logs 1panel

在输出日志中查找类似以下格式的登录信息：

“`

1Panel login information:

URL: http://your_server_ip:20000/
Username: 1panel
Password: your_generated_password

“`

同样，请妥善保存这些信息。

防火墙配置

无论您使用哪种安装方式，防火墙配置都是非常重要的一步。如果您的服务器有防火墙，需要手动开放 1Panel 的管理端口 (20000) 以及您计划使用的其他端口（如 80, 443）。

1. 服务器内部防火墙 (以 CentOS/Ubuntu 为例)

  • CentOS 7/8/9+ (使用 firewalld):

    bash
    sudo firewall-cmd --zone=public --add-port=20000/tcp --permanent
    sudo firewall-cmd --zone=public --add-port=80/tcp --permanent # 如果需要部署网站
    sudo firewall-cmd --zone=public --add-port=443/tcp --permanent # 如果需要部署网站
    sudo firewall-cmd --reload

  • Ubuntu 18.04/20.04/22.04+ (使用 ufw):

    bash
    sudo ufw allow 20000/tcp
    sudo ufw allow 80/tcp # 如果需要部署网站
    sudo ufw allow 443/tcp # 如果需要部署网站
    sudo ufw enable # 如果 ufw 未启用，请启用

2. 云服务商安全组/防火墙

如果您使用的是云服务器（如阿里云、腾讯云、AWS、Google Cloud 等），还需要登录到云服务商的管理控制台，在对应的安全组或防火墙规则中，添加入站规则，允许 TCP 协议的 20000 端口以及其他所需端口（如 80, 443）对外开放。具体操作请参考您的云服务商文档。

访问 1Panel 面板

  1. 在您的浏览器中输入安装成功后输出的 1Panel URL。例如：http://your_server_ip:20000/。
  2. 输入之前记录的用户名和密码。
  3. 点击登录，即可进入 1Panel 的管理界面。

首次登录后的配置

首次登录 1Panel 后，建议您进行以下操作：

  1. 修改默认密码：为了安全起见，立即修改默认生成的管理员密码。
  2. 绑定域名 (可选)：如果您有域名并希望通过域名访问面板，可以配置域名绑定。
  3. 安装常用应用：1Panel 应用商店提供了 Nginx、MySQL、Redis、WordPress 等丰富的应用，您可以根据需求一键安装。
  4. 配置安全设置：如 IP 白名单、面板访问限制等。

常见问题与故障排除

  • 无法访问面板：
    • 检查服务器 IP 地址和端口是否正确。
    • 检查服务器内部防火墙（firewalld 或 ufw）是否开放了 20000 端口。
    • 检查云服务商的安全组/防火墙是否开放了 20000 端口。
    • 使用 netstat -ntlp | grep 20000 命令检查 1Panel 进程是否监听在 20000 端口。
  • Docker 未运行：使用 sudo systemctl status docker 检查 Docker 服务状态，如果未运行，使用 sudo systemctl start docker 启动。
  • 登录信息丢失：
    • 如果是一键脚本安装，可以尝试重新运行脚本，它可能会提示已安装并再次输出信息。
    • 如果是手动安装，可以尝试 docker logs 1panel 查看容器日志找回。
    • 终极方案是重置密码，具体方法请查阅 1Panel 官方文档。

总结

通过以上步骤，您应该已经成功安装并配置了 1Panel 服务器面板。1Panel 友好的界面和强大的功能将帮助您更高效地管理您的服务器和部署各种应用。现在，您可以开始探索 1Panel 的各项功能，享受便捷的服务器运维体验了！

滚动至顶部