用 Docker 部署 Seafile 最轻量易维护，核心是通过 docker-compose.yml 一键启动 MariaDB、Memcached 和 Seafile 三容器并自动组网；需先安装 Docker 和 docker-compose，创建 /seafile 目录结构，配置 ports、DB_HOST 等关键环境变量，首次启动自动初始化数据库和管理员账户。
用 Docker 部署 Seafile 是目前最轻量、最易维护的方式，尤其适合个人或小团队快速落地。核心思路是：用 docker-compose.yml 一键拉起数据库（MariaDB）、缓存（Memcached）和 Seafile 主服务三个容器，它们自动组网、按需通信，无需手动配置端口转发或服务依赖顺序。
准备基础环境与目录结构
先确保系统已安装 Docker 和 docker-compose（v2.0+）。不建议用 root 用户直接运行，推荐新建普通用户并加入 docker 组：
-
sudo usermod -aG docker your_username，然后重新登录生效 - 创建统一工作目录，例如
/seafile，按用途分出子目录：/seafile/data/seafile-data（存放所有用户文件）/seafile/data/db-data（MySQL 数据持久化）/seafile/logs（可选，用于收集各容器日志） - SSD 存储更佳；4GB 内存起步，若用户超 10 人建议升至 8GB+
编写并启动 docker-compose.yml
在 /seafile 下新建 docker-compose.yml，内容如下（以社区版 latest 为例）：
version: '3.7'
services:
db:
image: mariadb:10.5
container_name: seafile-mysql
volumes:
- ./data/db-data:/var/lib/mysql
environment:
- MYSQL_ROOT_PASSWORD=your_strong_password
- MYSQL_LOG_CONSOLE=true
<p>memcached:
image: memcached:1.6
container_name: seafile-memcached
entrypoint: memcached -m 256</p><p>seafile:
image: seafileltd/seafile-mc:latest
container_name: seafile-server
depends_on:</p><ul><li>db</li><li>memcached
volumes:</li><li>./data/seafile-data:/shared
ports:</li><li>"8000:80"
environment:</li><li>DB_HOST=db</li><li>DB_ROOT_PASSWD=your_strong_password</li><li>SEAFILE_ADMIN_EMAIL=admin@example.com</li><li>SEAFILE_ADMIN_PASSWORD=your_secure_admin_pass
关键点说明：
-
ports: "8000:80"表示通过宿主机 8000 端口访问 Seafile Web 界面；如需 HTTPS，后续再反向代理处理 -
DB_HOST必须填容器名db（不是 localhost），这是 Docker 内部 DNS 自动解析的名称 - 首次启动会自动初始化数据库和管理员账户，邮箱和密码即为登录 Web 的凭证
常见问题应对：502 错误重点排查
页面打开显示 502，大概率不是 Nginx 或反代问题，而是 Seafile 容器无法连上数据库。可按以下顺序检查：
- 执行
docker logs seafile-server，看是否有Can't connect to MySQL server类报错 - 确认
DB_HOST和DB_ROOT_PASSWD是否与db容器中设置完全一致 - 进入数据库容器验证：
docker exec -it seafile-mysql mysql -uroot -pyour_strong_password -e "show databases;" - 如果数据库刚启动，Seafile 可能抢在它就绪前尝试连接，可在
seafile服务下加restart: unless-stopped并稍等 30 秒再重试
后续可用性增强建议
上线后别忘了这几件事，让系统更稳更安全：
- 用 nginx 或 caddy 做反向代理，启用 HTTPS（Let’s Encrypt 免费证书）
- 把
SEAFILE_ADMIN_EMAIL换成真实邮箱，方便找回密码和接收系统通知 - 定期备份
./data/db-data和./data/seafile-data目录（注意不要只备份空目录） - 如需外网访问，确保云服务器安全组/防火墙放行 8000 端口（或你映射的端口）
