Zulip生产环境必须使用官方安装脚本而非apt或AppImage，因其严格依赖PostgreSQL、Redis、RabbitMQ和Nginx协同，且需域名、HTTPS、时间同步等硬性前置条件。
Zulip 生产环境不能直接用 apt install zulip-server 或 AppImage 启动就完事——它依赖 PostgreSQL、Redis、RabbitMQ 和 Nginx 的协同，且官方安装脚本会接管系统服务管理。跳过准备步骤强行运行，90% 的失败都卡在端口冲突、Python 环境污染或 DNS 解析失败上。
为什么必须用官方安装脚本而不是包管理器
Ubuntu/Debian 官方仓库里的 zulip-server 包是极老的快照（通常滞后 2–3 个大版本），不带 RabbitMQ 集成逻辑，也不生成正确的 systemd service 文件。官方脚本 ./scripts/setup/install 才是唯一被持续测试的路径，它会：
- 自动检测并停用系统已有的 Apache/Nginx（避免端口 80/443 冲突）
- 用
pip安装严格版本锁定的 Python 依赖（Django 4.2.x、psycopg3、celery 5.3+） - 初始化 PostgreSQL schema 并设置
zulip数据库用户权限 - 配置 Redis 的
database 0专用于缓存，database 1专用于队列
你看到的 “Connection refused” 错误，八成是因为手动启了另一个 Nginx，把 Zulip 自带的 nginx.conf 覆盖掉了。
域名和 HTTPS 是硬性前置条件，不是可选项
Zulip 的 Web 前端强制校验 settings.EXTERNAL_HOST 必须是完整域名（如 chat.example.com），且必须能通过公网解析。本地 localhost 或 192.168.x.x 直接报 500 错误。HTTPS 更是启动即强制：
- 安装脚本会调用
certbot自动申请 Let’s Encrypt 证书；若你禁用自动申请（--self-signed-cert），浏览器会因证书不受信而拒绝加载 WebSocket 连接 - 邮件通知功能（
EMAIL_HOST）默认走 STARTTLS，若 SMTP 服务器要求 TLS 但你的域名没配好 DNS，manage.py send_test_email会卡住超时 - 移动端 App 会拒绝连接 HTTP 地址，连登录页都打不开
临时调试可用 nginx -t && systemctl restart nginx 检查反向代理是否把 /api 和 /socket.io 正确转发到 127.0.0.1:9993（Zulip 的 Tornado 进程监听端口）。
用户数规模直接决定你能否省掉 RabbitMQ
RabbitMQ 不是“可选消息队列”，而是 Zulip 实时推送的中枢。即使只有 5 个用户，send_email_from_server、deliver_push_notifications、notify_tornado 这三个关键任务也全靠它调度。常见误操作：
- 以为用 Redis 替代 RabbitMQ 就行 —— 不行。
settings.RABBITMQ_HOST是硬编码在 Celery 配置里的，改了会直接 crash - 在小内存机器上关闭 RabbitMQ 服务 ——
supervisorctl status里能看到queue-workers反复 exit，日志里全是ConnectionRefusedError: [Errno 111] Connection refused - 修改
/etc/rabbitmq/rabbitmq-env.conf把NODE_IP_ADDRESS=127.0.0.1改成0.0.0.0—— 这会让 Erlang epmd 暴露在公网，官方明确警告这是安全风险
真正能精简的只有前端静态资源：如果你用 CDN 托管 /static，可以注释掉 Nginx 配置里 location /static 块，但后端服务链一个都不能少。
邮件配置失败时别碰 settings.py 手动改
Zulip 的邮件系统由两层组成：Django 的 EMAIL_* 配置项控制发信行为，而 zproject/email_log.py 控制日志输出。直接编辑 /etc/zulip/settings.py 容易触发语法错误导致整个 Django 进程启动失败。正确做法是：
- 用
/etc/zulip/zulip-secrets.conf存敏感字段：email_host_password = your_app_password - 在
/etc/zulip/settings.py里只写非密钥项：EMAIL_HOST = 'smtp.gmail.com'、EMAIL_PORT = 587 - 测试命令必须用 Zulip 用户执行：
su zulip -c '/home/zulip/deployments/current/manage.py send_test_email admin@example.com'
如果收到 SMTPAuthenticationError，优先检查 Gmail 是否开启“允许不够安全的应用”，或者换成 Mailgun/Postfix 本地中继——Zulip 对 SMTP 协议兼容性很好，但对 OAuth2 流程支持有限。
最常被忽略的是时间同步：Zulip 的 JWT token 校验依赖系统时钟，误差超过 5 分钟就会提示“Invalid token”。部署完第一件事就是跑 timedatectl set-ntp true，别信 date 命令显示的时间。
