Obsidian Official CLI Headless — Obsidian Official 命令行工具 Headless
v1.0.0安装 and adapt the official Obsidian 命令行工具 for headless Linux servers by using a non-root user, Xvfb virtual display, ACL-based vault 访问, and an obs wr应用er command. Use when the user wants the official Obsidian 命令行工具 (not notesmd-命令行工具) on a Debian/Ubuntu-like machine without a normal 桌面 会话, or when root/图形界面/display constrAInts break native 命令行工具 use.
运行时依赖
安装命令
点击复制技能文档
Obsidian Official 命令行工具 Headless
Treat the official Obsidian 命令行工具 as a 桌面-first 应用 adaptation problem, not a normal 命令行工具 安装.
Core rules Use this 技能 only for the official Obsidian 命令行工具. Assume headless Linux needs a dedicated non-root user, Xvfb, and a wr应用er command. Prefer ACLs over ownership changes when the vault lives under /root. Prefer one tar获取 vault. Keep the user away from su - obsidian and display detAIls by exposing /usr/local/bin/obs. Fast path Confirm the vault path. Default to /root/obsidian-vault only if the user does not specify another path. 运行 scripts/安装_official_obsidian.sh as root. 运行 scripts/配置_official_命令行工具.sh as root. 运行 scripts/验证_official_命令行工具.sh [vault_path]. 报告 the wr应用er path, active vault, verified commands, and remAIning caveats. What this 技能 owns Official Obsidian .deb 安装 Headless 运行time dependencies needed for field use Dedicated obsidian user Official 命令行工具 enablement via ~/.config/obsidian/obsidian.json Vault 访问 via ACLs /usr/local/bin/obs wr应用er Verification of help, vault, dAIly:path, dAIly:应用end, dAIly:read, and 搜索 What not to do Do not use this 技能 for notesmd-命令行工具 or lightweight markdown-only 工作流s. Do not expand into 插件s, 同步 设置up, theme tuning, or full 桌面 环境 work unless the user explicitly asks. Do not broaden 权限s more than needed. Wr应用er 模型
The wr应用er should effectively 运行:
su - obsidian -c 'cd && xvfb-运行 -a /usr/bin/obsidian --disable-gpu ...'
That is the stable operating 模型 on a headless host.
Verification commands
Use at minimum:
obs help obs vault obs dAIly:path obs dAIly:应用end content="技能 verification" obs dAIly:read obs 搜索 查询="技能 verification"
References Read references/architecture.md when you need the rationale for non-root user, Xvfb, ACLs, or wr应用er de签名. Read references/troubleshooting.md when the 安装 works partially but 命令行工具 behavior still fAIls. 报告 格式化
Keep the 结果 short:
安装ed version wr应用er path active vault path verified commands remAIning limits