前言

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

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

前期准备

  • 一台云服务器
  • 一个域名



开始搭建

第一步：更新系统软件

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

sudo apt update && sudo apt upgrade -y

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


第二步：安装必要环境 Docker + Nginx

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

运行完后重新连接服务器，让权限生效
7.安装 Nginx

sudo apt install -y nginx

8.启动 Nginx 并设置开机自启动

sudo systemctl start nginx
sudo systemctl enable nginx


第三步：部署前后端集成版

1.一键安装前后端(8085:80可以换成8080:80或其他)

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

2.检查是否运行成功

docker ps

如果看到pansou相关说明启动成功！
此时已经可以访问http://服务器IP:8085进行测试了


第四步：绑定域名(请提前解析域名)

1.创建网站配置文件

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

2.粘贴以下内容（把你的域名换成你自己的域名，如pan.moyuans.cn）

server {
    listen 80;
    server_name 你的域名;

    location / {
        proxy_pass http://127.0.0.1:8085;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

粘贴后按Ctrl+O保存，Ctrl+X退出
3.启用配置

sudo nginx -t
sudo systemctl restart nginx

4.配置https（把你的域名替换为你实际的域名，如pan.moyuans.cn）

sudo apt install -y certbot python3-certbot-nginx
sudo certbot --nginx -d 你的域名

此时访问你的域名即可开始使用PanSou



常用指令

停止服务：docker stop pansou

启动服务：docker start pansou

查看日志：docker logs -f pansou

重启服务：docker restart pansou

至此终端版的PanSou就搭建完成了！
如果有疑问可联系2849385816