Outline 官方无 Linux 桌面客户端，仅支持 Docker 部署服务端；需专用 PostgreSQL（含 pg_trgm/btree_gin）、Nginx 反向代理（含 WebSocket 头配置）及公网可访问域名，不支持裸机直装或离线使用。
Outline 官方没有 Linux 桌面客户端，所谓“Linux 安装 Outline 知识库”实际是指在 Linux 上运行 Outline Server（服务端），或通过浏览器访问已部署的 Outline 实例——它本身不是本地知识库软件，而是一个基于 Markdown 的协作 Wiki 服务。
Outline Server 能不能直接装在 Ubuntu/Debian 上？
可以，但必须用 Docker 部署，官方不提供 deb/rpm 包或 systemd 服务脚本。裸机安装 Node.js + PostgreSQL 手动配置极易出错，Docker 是唯一被官方文档支持的方式。
-
docker和docker-compose必须提前装好（Ubuntu 推荐用apt install docker.io docker-compose，别用 snap 版） - PostgreSQL 数据库不能复用已有实例——Outline Server 要求
pg_trgm和btree_gin扩展，且需专用用户与数据库 -
.env文件里URL必须填公网可访问地址（比如https://outline.example.com），填http://localhost会导致 Websocket 失败、编辑器无法加载
为什么 docker-compose up -d 后打不开网页？
最常见原因是反向代理没配或 SSL 终止位置错误。Outline Server 默认只监听 localhost:3000，不暴露 HTTP/HTTPS 端口，必须前置 Nginx 或 Caddy。
Docker Image Puller
下载
使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。
- Nginx 配置里漏掉
proxy_set_header Upgrade $http_upgrade;和proxy_set_header Connection "upgrade";→ 导致 WebSocket 连接被降级，页面卡在加载状态 - Let’s Encrypt 证书路径写错（如
/etc/letsencrypt/live/example.com/fullchain.pem少了fullchain）→ Nginx 启动失败，docker-compose ps显示outline容器是 Up 但nginx是 Exited - 防火墙没放开 443 端口（
ufw allow 443），或云服务器安全组未放行 → 外网根本连不上
能不能绕过 Docker，用 Node.js 直接跑？
技术上可行，但不推荐。Outline Server 的 package.json 声明了 "engines": {"node": ">=18.17.0"}，且依赖 libpq-dev、python3（编译 node-gyp）、git（动态加载插件）等系统组件。
- 手动
npm ci极易卡在sharp或pg-native编译环节，尤其在 ARM64（如树莓派）上几乎必失败 - 环境变量必须全部对齐 Docker Compose 中定义的 20+ 个参数（如
SECRET_KEY、REDIS_URL、SLACK_CLIENT_ID），漏一个就会报Error: Invalid configuration - 升级困难：每次
git pull后要重跑npm run build，而 Docker 只需改image:标签再docker-compose pull && up -d
真正容易被忽略的是：Outline 不同步本地文件，所有内容存在 PostgreSQL 里；导出备份必须用 pg_dump，而不是复制某个目录。想当离线知识库用？它不适合——没离线模式，也没桌面客户端。
