Linux安装Seafile企业云盘详细教程

首先给出明确建议：切勿使用 apt install seafile-server。官方源中的版本通常滞后，安装后极易缺少必要模块、启动失败，并伴随大量错误——推荐直接下载官方预编译的 tarball 安装。以下是基于实际踩坑经验汇总的详细安装指南。

为何不推荐通过 apt 或 yum 安装 Seafile

Debian/Ubuntu 官方仓库中的 seafile-server 版本通常停留在 7.1.x，而当前稳定版已超过 12.0。版本滞后会引发一系列连锁问题，例如缺少 systemd 单元文件、Python 依赖混乱，常见的错误有 ImportError: No module named 'django' 和 seaf-server not found。同样，CentOS/RHEL 的 EPEL 软件包也较为陈旧，且不兼容新版 MySQL 认证插件。官方文档反复强调：务必选择官网提供的 tarball 进行安装。

下载和解压 Seafile tarball 的关键步骤

请从 Seafile 官方网站下载页面获取 seafile-server__x86-64.tar.gz 文件，注意不要下载源代码、Docker 镜像或 GitHub Actions 构建产物。解压后需确保目录结构正确：在 seafile-server- 目录下应直接包含 setup-seafile.sh、seafile.sh、seahub.sh 等脚本文件。

• 错误做法：使用 tar -zxvf ... -C /opt 指定解压路径，会导致多一层嵌套，使得 ./setup-seafile.sh 无法定位自身。
• 正确做法：在目标目录下直接执行 tar -zxvf seafile-server_*.tar.gz，不加 -C 参数。
• 验证步骤：进入解压后的目录，执行 ls -l，应看到 conf/、seafile-data/、logs/ 等子目录为空（后续脚本会自动创建）。

MySQL 配置中容易卡住的三个关键点

当执行 setup-seafile-mysql.sh 并在“creating seafile database…”阶段卡住时，90% 的情况是由于 MySQL 权限或连接配置问题。以下细节需要特别留意：

• 创建用户时务必使用 CREATE USER 'seafile'@'localhost' IDENTIFIED WITH mysql_native_password BY 'xxx';，因为 CentOS 7 默认使用 auth_socket 插件，不兼容将直接导致卡死。
• 授权语句中需包含 CREATE、DROP、SELECT、INSERT、UPDATE、DELETE 等权限，缺一不可。
• 在脚本中填写数据库主机时，应使用 localhost 而非 127.0.0.1，MySQL 通过 socket 连接逻辑不同，使用 IP 会导致失败。
• 检查 /etc/my.cnf 配置文件中是否包含 skip-networking，并确保 bind-address 未被强制设置为 127.0.0.1。

启动后局域网无法访问？修改 gunicorn.conf 和防火墙设置

默认情况下，seahub 仅监听 127.0.0.1:8000，因此其他设备访问 http://:8000 时会超时。解决步骤非常简单：

• 编辑 conf/gunicorn.conf 文件，将 bind = "127.0.0.1:8000" 修改为 bind = "0.0.0.0:8000"。
• 在 Ubuntu/Debian 系统中执行 sudo ufw allow 8000 开放端口。
• 在 CentOS/RHEL 系统中执行 sudo firewall-cmd --permanent --add-port=8000/tcp && sudo firewall-cmd --reload。
• 修改完成后重启服务：./seafile.sh restart && ./seahub.sh restart。

一个容易被忽视的要点是：由 setup-seafile.sh 自动创建的路径（如 conf/、seafile-data/、logs/）在创建后不可移动或重命名，否则 seafile.sh 启动时会因硬编码的相对路径无法找到而直接报错退出。