一、Seafile 是什么
Seafile 是开源的云存储与文件同步平台,可以自建一套类似”私有网盘”的服务。跟 Nextcloud 相比,Seafile 更强调文件同步性能和协作,库(Library)是它的核心概念——每个库是一组文件,可以单独共享、设定权限。
Seafile 服务器由几个组件构成:
seafile-server —— 核心服务,负责文件存储、同步、版本管理
seahub —— Web 界面(Django 写的),负责登录、分享、权限
依赖 —— MariaDB/MySQL(元数据)、Memcached(缓存)、可选 Elasticsearch(全文搜索)
本文用 Docker 部署社区版,覆盖部署安装 + 基础配置 + 使用配置三部分。
二、Docker 部署
2.1 准备
Seafile 12.0 起使用三个配置文件:.env、seafile-server.yml、caddy.yml。先从官方拉取模板:
1 | mkdir -p /opt/seafile |
最低配置:2 核 CPU、2GB 内存。
2.2 修改 .env
编辑 .env,重点改这几项:
1 | # Seafile 数据持久化目录 |
注意:SEAFILE_SERVER_HOSTNAME 填域名时,Seafile 会用它拼出访问地址;如果只有 IP,就直接填 IP。
2.3 启动
1 | cd /opt/seafile |
首次启动会自动初始化数据库和 Seafile 配置,需要几分钟。查看进度:
1 | docker compose logs -f seafile |
看到类似这样就是成功了:
1 | Seafile server started |
访问 http://<服务器地址>/(或域名),用 .env 里设置的管理员账号登录。如果看到 502,说明初始化还没完成,等日志出现上面的内容再试。
三、访问方式(有域名 / 无域名 / 无公网 IP+FRP)
Seafile 的访问方式取决于你有没有域名、有没有公网 IP。.env 里的 SEAFILE_SERVER_HOSTNAME 必须和实际访问地址一致,客户端才能连上。
3.1 有域名 + 公网 IP(推荐)
- DNS 解析:把域名 A 记录指向服务器公网 IP
.env设置:1
2SEAFILE_SERVER_HOSTNAME=seafile.example.com
SEAFILE_SERVER_LETSENCRYPT=true- 确保 80/443 端口开放(防火墙/安全组)
docker compose up -d,Seafile 用 Caddy 自动申请 Let’s Encrypt 证书
访问 https://seafile.example.com。客户端填的地址也是这个。
3.2 无域名(有公网 IP)
直接用 IP 访问,不配 HTTPS(或自签证书):
1 | SEAFILE_SERVER_HOSTNAME=203.0.113.10 |
访问 http://203.0.113.10。客户端填 http://203.0.113.10。
注意:用 IP 访问时浏览器会提示”不安全”(HTTP),属于正常。如果要 HTTPS 就得用域名 + 证书,IP 一般申请不到可信证书。
3.3 无公网 IP,通过 FRP 内网穿透
场景:Seafile 跑在家里/内网机器,没有公网 IP。用一个有公网 IP 的服务器(如你的 xyt 那类云主机)做 FRP 中继。
步骤 1:公网服务器上跑 frps(frps.toml):
1 | bindPort = 7000 |
启动:frps -c frps.toml
步骤 2:内网机器(Seafile 所在)跑 frpc(frpc.toml):
1 | serverAddr = "公网服务器IP" |
没有域名时,type 用 tcp 直接映射端口:
1 | [[proxies]] |
步骤 3:配置 Seafile
有域名(customDomains 方式):
1 | SEAFILE_SERVER_HOSTNAME=seafile.example.com |
无域名(tcp 方式):
1 | SEAFILE_SERVER_HOSTNAME=公网服务器IP |
客户端访问:
- 有域名:
http://seafile.example.com - 无域名:
http://公网服务器IP:8080
要点:
- FRP 只转发流量,Seafile 本身还是
SEAFILE_SERVER_HOSTNAME决定客户端地址,两者必须一致 - 有域名 + HTTPS 时,证书放在 frps 端(或用域名商/CF 反代),Seafile 内部保持 http,避免内网证书配置复杂化
- frpc 可以配
systemd服务开机自启,断线自动重连
四、基础配置
4.1 系统设置
登录 Web 界面后,右上角头像 → 系统管理 → 设置,配置:
站点名称、站点描述
服务器地址(如果 .env 填对了通常自动正确)
注册是否开放(默认关闭,建议保持关闭)
4.2 邮箱通知(可选)
系统管理 → 邮件通知,填 SMTP 服务器、端口、账号密码,用于密码找回、分享通知。没有 SMTP 可以先跳过,不影响核心功能。
五、使用配置
5.1 创建库并上传文件
登录后”我的图书馆”→ 新建图书馆(库),起名后进入,直接拖拽上传文件。Seafile 的库是文件同步和共享的基本单位。
5.2 客户端同步
Seafile 提供 Windows / macOS / Linux / Android / iOS 客户端。
以 Linux 为例(客户端下载自官网):
1 | # 安装后首次连接填服务器地址 + 账号密码 |
同步要点:
客户端填的地址 = 服务器地址 + 端口(如 https://seafile.example.com)
每个库可以单独选择同步到本地哪个目录
增量同步,只传改动部分,性能比全量好
5.3 共享与权限
Seafile 的共享核心是”库”和”文件夹”两级:
共享库 —— 在库上右键"共享",可共享给指定用户/群组,或生成只读/读写链接
共享文件夹 —— 库内的子文件夹也能单独共享
权限粒度:
读写 —— 对方可改文件,改动会同步回你的库
只读 —— 对方只能下载/预览
上传-only —— 对方只能传文件进库,看不到原有内容(适合收作业/收集资料)
5.4 外部存储挂载(可选)
如果已有对象存储(比如你之前部署的 minio),可以把 S3 兼容存储挂载到 Seafile,把大文件放到对象存储里,减轻本地磁盘压力。
系统管理 → 存储后端,添加 S3 兼容存储:
服务地址(endpoint,如 http://minio.example.com:9000)
Bucket、Access Key、Secret Key
挂载位置(如 /s3-storage)
这样库里的文件可以存到 S3,Seafile 只存元数据。
5.5 文件历史与版本管理
Seafile 默认保留文件历史版本,这是它比普通网盘强的地方:
文件历史 —— 库/文件上"历史"可以查看每次修改、下载旧版本、恢复
版本数量限制 —— 系统管理可设置保留多少版本(默认保留一定数量/时间)
适合当重要文件的版本备份工具,改坏了能一键回滚。
六、验证与常见问题
6.1 部署验证清单
Web 界面能登录(管理员账号)
能创建库、上传/下载文件
客户端能同步
共享链接能访问
6.2 常见问题
502 网关错误:Seafile 还没初始化完成,docker compose logs -f seafile 等日志出现 “Seahub is started” 再访问。
端口冲突:默认 80 端口被占用时,改 caddy.yml 里映射的宿主机端口。
忘记管理员密码:
1 | docker compose exec seafile /opt/seafile/seafile-server-latest/reset-admin.sh |
按提示重置。
升级 Seafile:修改 .env 里的镜像版本号,docker compose pull && docker compose up -d。升级前备份 /opt/seafile-data。
备份:Seafile 数据全在 SEAFILE_VOLUME(默认 /opt/seafile-data),直接备份该目录即可,数据库也在里面。
小结
Seafile 用 Docker 部署很省心:三个配置文件改一改、docker compose up -d 就起来了。核心概念是”库”,共享、同步、权限都围绕库展开。跟 minio(对象存储)配合使用可以构建一个完整的自建云存储体系——minio 存大文件,Seafile 管同步和协作,各司其职。
评论