前言

如果你是想搭建个人网盘搜索工具的纯小白，又苦于网上教程要么步骤零散，要么满屏专业术语看不懂，那这篇文章绝对适合你。今天我们就以 pansou 这个开源项目为例，手把手带你完成从服务器环境配置、Docker 一键部署前后端集成版，到域名绑定、HTTPS 配置的全流程。

全程基于 Ubuntu 24.04 LTS 系统，所有命令直接复制粘贴即可运行，没有复杂的代码修改，就算你是电脑小白，跟着步骤走也能轻松搞定。话不多说，咱们直接开干！

前期准备：

1.一台服务器vps(1元试用7天无理由退款点我直达)

2.一个域名 （实测免费域名注册合集持续更新...）

第一步：更新系统

首先更新系统软件包，确保环境最新（复制粘贴下面的命令，按回车执行）：

sudo apt update && sudo apt upgrade -y

• 执行后可能会要求输入你的服务器登录密码（输入时屏幕不会显示，输完按回车即可）

第二步：安装 Docker（推荐新手使用的部署方式）

Docker 是一种简单的部署方式，不需要复杂配置

1. 安装 Docker 依赖：

sudo apt install -y apt-transport-https ca-certificates curl software-properties-common

2. 添加 Docker 官方 GPG 密钥：

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

3. 添加 Docker 软件源：

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

4. 再次更新软件包列表：

sudo apt update

5. 安装 Docker：

sudo apt install -y docker-ce

6. 启动 Docker 并设置开机自启：

sudo systemctl start docker
sudo systemctl enable docker

运行完后重新连接服务器，让权限生效

三、部署前后端集成版

1. 一键启动服务：

docker run -d --name pansou -p 80:80 ghcr.io/fish2018/pansou-web

• 解释：这条命令会自动下载并启动程序，默认使用 80 端口

2. 检查是否运行成功：

docker ps

• 如果看到pansou相关的记录，说明启动成功

四、绑定域名（详细步骤）

前提：你需要先有一个域名，并做好解析（将域名指向你的服务器 IP）

1. 安装 Nginx（用于绑定域名）

sudo apt install -y nginx

sudo systemctl start nginx

sudo systemctl enable nginx

2. 创建网站配置文件

sudo nano /etc/nginx/sites-available/pansou

粘贴以下内容（把你的域名换成你自己的域名，如pan.example.com）：

nginx

server {
    listen 80;
    server_name 你的域名;  # 替换成你的域名

    location / {
        proxy_pass http://127.0.0.1:80;  # 转发到本地80端口
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

按Ctrl+O保存，Ctrl+X退出

3. 启用配置

sudo ln -s /etc/nginx/sites-available/pansou /etc/nginx/sites-enabled/
sudo nginx -t  # 检查配置是否有误
sudo systemctl restart nginx

4. 配置 HTTPS（可选但推荐）

# 安装证书工具
sudo apt install -y certbot python3-certbot-nginx

# 申请免费证书（替换成你的域名）
sudo certbot --nginx -d 你的域名

按照提示操作，选择2自动跳转 HTTPS

五、常用操作

1. 停止服务：docker stop pansou

2. 启动服务：docker start pansou

3. 查看日志：docker logs -f pansou

4. 重启服务：docker restart pansou

六、访问测试

在浏览器输入你的域名（如https://你的域名），如果能看到 PanSou 的界面，说明部署成功！