常见问题
部署与登录
拉不到镜像
先确认执行过 docker login，账号密码是交付的只读账号。服务器在阿里云杭州 VPC 里时走内网地址更快：
docker login crpi-6q638zy09wmnj70w-vpc.cn-hangzhou.personal.cr.aliyuncs.com
./install-pro.sh --pro-registry crpi-6q638zy09wmnj70w-vpc.cn-hangzhou.personal.cr.aliyuncs.com/knowflow-pro
登录后又回到登录页
用 http 访问时，.env 里的 KNOWWORK_COOKIE_SECURE 必须是 false。改完在部署目录执行 docker compose up -d。
云服务器上打不开
脚本自动取到的是内网 IP。用 ./install-pro.sh --url http://公网IP:8080 重跑，并在安全组里放行 8080 端口。
授权显示无效
license/目录里只能有一份.license文件；- 确认授权没有过期；
- 换了授权文件后，在部署目录里执行
docker compose restart api worker。
系统管理员的账号交接
系统管理员目前只有初始化时建的那一个账号，不能转交。所以建议一开始就用 IT 部门的公共邮箱建，交接时交接账号密码即可，见角色与管理员。
知识库
文档一直解析失败
- 先看系统管理员有没有在「模型」→「文档解析」里配好 MinerU；
- 确认 KnowWork 服务器能访问到 MinerU；
- 打开文档的「详情」→「后台任务」，失败原因写在那里。
服务类的问题（MinerU 暂时连不上等）会自动重试，排除后也可以手动「重新解析」。
文档一直在「排队中」
系统管理员到「运行面板」看 worker 是否在线、队列是否堆积。MinerU 的并发上限较小时，大批上传会排队，属于正常现象。
明明有这份文档，却答不出来
到知识库的「检索测试」里问同一个问题，看能不能命中正确的片段，再按答不准时怎么排查处理。常见原因是员工的说法和文档写法不一样，加同义词通常就能解决。
换嵌入模型要注意什么
知识库建好、有了文档以后再换嵌入模型，要整库重建索引，文档多时耗时较长，也会产生嵌入费用。建库时就选定比较稳妥。
新旧两版制度都被引用了
用「上传新版本」替换旧文档，或者确认系统识别出的新旧版本，旧版就不再参与问答，见文档管理。
数据与安全
数据存在哪里
全部在你们自己的服务器上：数据库、文档原件、向量、对话记录都在部署的 Docker 卷里。KnowWork 只会访问你们配置的模型服务和 MinerU。
模型会看到哪些数据
模型只看到每一轮对话需要的内容：员工的问题、检索到的知识库片段、附件内容。用云上的模型服务时，这些内容会发送给该服务商；对数据外发有要求的，请使用私有化部署的模型。
智能助手执行命令安全吗
每个对话有一个独立的沙箱容器，命令和文件读写都在容器里，碰不到服务器本身、数据库和别人的数据。沙箱去掉了全部 Linux 能力、禁止提权，可以设置完全断网，见安装部署。写入类和高风险的工具调用执行前要提问人批准。
不需要沙箱可以吗
可以用 ./install-pro.sh --no-sandbox 安装。代价是智能助手不能执行命令、生成不了 Word 和 Excel，知识库的 PPT 预览和表格公式重算也用不了。
支持哪些登录方式
账号密码、邀请注册、OIDC 单点登录，以及给程序调用的个人 API Key。
获取帮助
商业版客户请联系交付对接人。也可以通过联系我们申请 POC 验证或咨询采购。