Elicit 私有化部署教程：反向代理、HTTPS 与多用户权限配置

部署前先明确：Elicit 私有化适合什么场景

Elicit 是面向科研阅读、论文检索、证据整理和文献摘要的 AI研究工具。很多团队希望把类似能力部署到自有环境中，原因通常有三类：一是研究资料不便直接上传到公共服务；二是团队需要统一账号、审计和权限；三是希望把文献库、向量检索、模型接口与内部知识流程打通。需要注意的是，实际部署前应先确认所使用版本、镜像、源码或企业授权是否允许私有化运行，不能把公共在线服务简单“搬运”为本地服务。

比较稳妥的架构是：前端 Web 服务负责交互，后端 API 负责文献解析、任务调度、模型调用和权限判断，数据库保存用户、项目、文献元数据，向量库保存语义索引，文件存储保存 PDF 与解析结果。对外访问时，由 Nginx、Caddy 或 Traefik 提供反向袋里与 HTTPS 入口，再把请求转发到内部服务。

一、环境与组件准备

建议使用一台 4 核 16GB 内存以上的 Linux 服务器作为起步环境；如果文献量较大或需要高并发解析，应把数据库、向量库和任务队列拆到独立节点。常见组件包括 Docker 与 Docker Compose、PostgreSQL、Redis、Qdrant 或 Milvus、对象存储服务、Nginx 或 Caddy。模型层可以接入企业已有的大模型网关，也可以接入本地推理服务，但要提前评估响应速度、上下文长度和成本。

部署前先规划域名，例如 research.example.com；准备 TLS 证书；创建独立运行用户；开放 80、443 端口，内部数据库端口不要暴露到公网。生产环境不要使用默认口令，所有密钥、模型接口令牌、数据库连接串都应放入环境变量或密钥管理系统，不要写死在前端文件中。

二、基础部署流程

第一步，拉取官方授权镜像或团队合规维护的项目代码，检查版本说明、依赖清单和升级记录。若项目提供 docker-compose.yml，可先在测试机启动最小环境：前端、后端、数据库、缓存和向量库。启动后先访问内部端口，确认登录页、健康检查接口、数据库迁移和任务队列都能正常工作。

第二步，初始化数据库。通常需要执行迁移命令，创建 users、projects、documents、roles、audit_logs 等表。初始化管理员账号时，建议只创建一个临时管理员，完成配置后立即修改高强度口令并开启二次校验。对于文献文件，建议按项目隔离目录或存储桶，避免不同团队资料混放。

第三步，配置模型与检索能力。后端一般需要设置 MODEL_PROVIDER、MODEL_API_KEY、EMBEDDING_MODEL、VECTOR_STORE_URL 等参数。若采用本地模型，应先单独验证摘要、问答和嵌入接口是否可用；若通过统一模型网关调用，应限制每个用户或项目的每日额度，避免批量任务造成资源耗尽。

三、反向袋里配置思路

反向袋里的作用是把外部统一入口转发到内部多个服务，并承担 HTTPS、压缩、超时、上传大小限制和访问日志。以 Nginx 为例，外部监听 443，server_name 指向研究工具域名，location / 转发到前端服务，location /api/ 转发到后端 API。若后端使用 WebSocket 或流式输出，还要保留 Upgrade、Connection 等请求头，并适当调大 proxy_read_timeout。

文献 PDF 上传经常超过默认限制，因此需要设置 client_max_body_size，例如 100m 或根据团队规范调整。袋里层还应加入 X-Forwarded-For、X-Forwarded-Proto 等头信息，便于后端识别真实访问来源和生成正确回调地址。若使用 Caddy，可以更简洁地完成证书申请与续期，但同样要明确反代目标、上传大小和日志路径。

四、HTTPS 与证书管理

HTTPS 不只是“浏览器不报警”，它还关系到账号凭据、论文文件和模型请求内容的传输安全。证书可以使用自动签发方案，也可以使用企业内部证书。外部访问场景建议使用可信证书；仅内网访问时，也要把根证书分发到团队设备，避免用户忽略安全提示。

部署后应检查三点：访问 http:// 是否能自动跳转到 https://；后端生成的链接是否仍然是 HTTPS；Cookie 是否设置 Secure、HttpOnly 与 SameSite。若登录后反复跳回登录页，常见原因是袋里没有传递协议头，或应用的 PUBLIC_URL、APP_BASE_URL 配置仍是内部地址。

五、多用户权限配置

多用户部署的核心不是“能注册账号”，而是项目、文献、注释、导出和管理动作都要有边界。建议采用角色模型：系统管理员负责全局配置、模型额度和审计；团队管理员负责成员邀请、项目创建和权限分配；研究员可以上传、检索、标注文献；访客或只读成员只能查看被授权内容。

权限配置时可以按项目维度划分，例如每个课题组一个 workspace，每个 workspace 下有独立文献库、索引和协作记录。敏感项目默认关闭公开邀请，成员加入需管理员批准。导出功能也要纳入权限控制，尤其是批量导出文献摘要、表格和问答记录时，应记录操作者、时间、项目和文件范围。

如果企业已有统一身份系统，可优先接入 OIDC、SAML 或 LDAP，减少重复账号管理。接入时要映射邮箱、姓名、部门和用户组，并设置默认角色。离职或项目结束后，应能一键停用账号并保留必要审计记录。不要让普通用户拥有系统配置、密钥查看、全局文献访问等高权限。

六、常见问题与排查

问题一：页面能打开，但 AI 摘要一直等待。通常是后端任务队列未启动、模型接口配置错误、Redis 不可用或网络出口被限制。先看后端日志，再测试模型接口，最后检查队列消费进程。

问题二：上传 PDF 成功，但检索不到内容。可能是解析服务失败、OCR 未启用、向量写入失败或项目索引未刷新。可抽取一篇简单英文论文测试，确认文本提取、分段、嵌入、入库四个环节。

问题三：登录后接口返回 401 或 403。401 多与令牌失效、Cookie 域名不一致有关；403 多与角色权限不足有关。检查反向袋里头、应用外部地址配置、用户角色和项目授权。

问题四：HTTPS 证书正常，但浏览器提示混合内容。说明前端仍在请求 http:// 的 API、图片或文件链接。需要统一配置 PUBLIC_API_URL，并清理旧缓存。

七、升级、回滚与备份建议

生产环境升级前必须备份数据库、文件存储和向量索引，并记录当前镜像版本、环境变量和配置文件。建议先在测试环境恢复一份脱敏数据，完成迁移验证后再安排低峰期升级。升级后重点检查登录、上传、检索、摘要、导出和权限边界。

回滚策略要提前准备：保留上一版镜像，数据库迁移脚本确认是否可逆，配置文件使用版本管理。若新版本修改了索引结构，回滚后可能需要重建索引，因此不要只备份数据库而忽略向量库和原始文件。

八、安全边界与实用建议

私有化部署并不等于绝对安全。管理员仍需建立使用规范：不得上传无授权资料；不得把模型输出直接当作最终研究结论；涉及重要决策时必须回到原文核验。AI 生成的摘要可能遗漏限定条件、样本范围或统计细节，研究人员应把它作为筛选与整理工具，而不是替代专业判断。

运维层面建议开启访问日志、错误日志和关键操作审计，定期检查异常登录、批量下载和高频模型调用。数据库、文件存储、模型密钥要分权管理，管理员账号不要多人共用。对于中小团队，推荐先从单机 Docker Compose 起步，稳定后再拆分数据库与向量库；对于院所或企业级团队，应尽早规划高可用、监控告警、容量评估和合规审查。

完成以上配置后，一个可用的 Elicit 私有化环境应具备四个特征：访问入口安全，模型调用稳定，项目资料隔离清晰，用户权限可追溯。真正影响长期体验的不是安装命令本身，而是证书、袋里、备份、角色和审计这些基础环节是否从第一天就设计到位。