Pingvin Share 项目安装部署完全指南

最新推荐文章于 2025-06-09 09:22:41 发布

原创最新推荐文章于 2025-06-09 09:22:41 发布 · 353 阅读

CC 4.0 BY-SA版权

Pingvin Share 项目安装部署完全指南

pingvin-share A self-hosted file sharing platform that combines lightness and beauty, perfect for seamless and efficient file sharing. 项目地址: https://gitcode.com/gh_mirrors/pi/pingvin-share

前言

Pingvin Share 是一个轻量级的文件分享解决方案，本文将详细介绍三种不同的安装方式，帮助用户根据自身需求选择最适合的部署方案。作为技术专家，我将从原理层面解析每种安装方式的优缺点，并提供实际部署中的注意事项。

一、Docker 容器化部署（推荐方案）

1.1 方案优势

容器化部署是目前最推荐的安装方式，具有以下技术优势：

环境隔离：所有依赖项封装在容器内部
一键部署：简化安装流程
便于维护：升级和回滚操作简单

1.2 详细步骤

获取 docker-compose 配置文件
执行部署命令：
```
docker compose up -d
```

1.3 技术细节

默认监听端口：3000
服务访问地址：http://localhost:3000
容器会自动处理前后端服务的依赖关系

二、Portainer 可视化部署

2.1 适用场景

适合习惯使用图形化管理界面的用户，特别适合：

不熟悉命令行操作的管理员
需要集中管理多个容器服务的场景

2.2 部署流程

进入Portainer的Stacks管理界面
创建新Stack并命名（如pingvinshare）
粘贴docker-compose文件内容
配置参数：
- 外部访问端口
- 环境变量（按需调整）
部署Stack

2.3 注意事项

端口映射关系需要正确配置
生产环境建议修改默认配置
监控容器资源使用情况

三、原生环境部署

3.1 前置要求

Node.js ≥ 22 版本
Git版本控制工具
pm2进程管理工具

3.2 后端服务部署

git clone 项目仓库
cd pingvin-share

# 获取最新稳定版本
git fetch --tags && git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

# 构建并启动后端
cd backend
npm install
npm run build
pm2 start --name="pingvin-share-backend" npm -- run prod

3.3 前端服务部署

cd ../frontend
npm install
npm run build
API_URL=http://localhost:8080 # 配置后端API地址
pm2 start npm --name "pingvin-share-frontend" -- run start

3.4 性能优化建议

对于大文件上传场景：

不建议使用内置反向代理
推荐方案：
- 采用Docker部署
- 自建高性能反向代理（如Nginx/Caddy）
- 调整上传大小限制参数

四、部署后验证

所有安装方式完成后，均可通过以下方式验证：

访问 http://localhost:3000
检查服务进程状态
查看日志输出

五、技术选型建议

| 部署方式 | 适用场景 | 维护难度 | 性能表现 | |---------|---------|---------|---------| | Docker | 快速部署/生产环境 | 低 | 优 | | Portainer | 可视化管理 | 中 | 良 | | 原生部署 | 深度定制开发 | 高 | 可调优 |