https://blog.ohtly.com/tags/livesync/ Recent content in Livesync on OHTLY Blog Hugo zh-cn Wed, 01 Jul 2026 12:29:20 +0800 https://blog.ohtly.com/posts/2026-07-01-self-hosted-livesync-config/ Wed, 01 Jul 2026 12:29:20 +0800 https://blog.ohtly.com/posts/2026-07-01-self-hosted-livesync-config/ <h2 id="背景"> 背景 <a class="heading-link" href="#%e8%83%8c%e6%99%af"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>Self-hosted LiveSync 插件的配置分散在多个设置页面，首次配置需要经过数步对话框引导，涉及 CouchDB 连接、同步模式、Doctor 诊断等多项设置。如果跨多台设备部署，每次手动点对话框效率低且难以保持一致。</p> <p>将配置收敛到插件目录下的 <code>data.json</code> 文件 + 服务器端 CLI 操作，可以实现可重复、可审计、跨设备一致的部署流程。</p> <h2 id="服务器端couchdb-初始化"> 服务器端：CouchDB 初始化 <a class="heading-link" href="#%e6%9c%8d%e5%8a%a1%e5%99%a8%e7%ab%afcouchdb-%e5%88%9d%e5%a7%8b%e5%8c%96"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h2> <p>Livesync 需要 CouchDB 作为同步后端。以 CouchDB 3.x 为例，通过 API 完成初始化。</p> <h3 id="创建数据库"> 创建数据库 <a class="heading-link" href="#%e5%88%9b%e5%bb%ba%e6%95%b0%e6%8d%ae%e5%ba%93"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h3> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X PUT -u admin:密码 http://couchdb:5984/笔记库名 </span></span></code></pre></div><h3 id="创建专用用户"> 创建专用用户 <a class="heading-link" href="#%e5%88%9b%e5%bb%ba%e4%b8%93%e7%94%a8%e7%94%a8%e6%88%b7"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h3> <p>为每个同步的 vault 创建独立用户，限制其权限范围：</p> <div class="highlight"><pre tabindex="0" style="color:#f8f8f2;background-color:#272822;-moz-tab-size:4;-o-tab-size:4;tab-size:4;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span>curl -X PUT -u admin:密码 <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> http://couchdb:5984/_users/org.couchdb.user:sync_用户名 <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> -H <span style="color:#e6db74">&#34;Content-Type: application/json&#34;</span> <span style="color:#ae81ff">\ </span></span></span><span style="display:flex;"><span><span style="color:#ae81ff"></span> -d <span style="color:#e6db74">&#39;{&#34;_id&#34;:&#34;org.couchdb.user:sync_用户名&#34;,&#34;name&#34;:&#34;sync_用户名&#34;,&#34;type&#34;:&#34;user&#34;,&#34;roles&#34;:[],&#34;password&#34;:&#34;随机密码&#34;}&#39;</span> </span></span></code></pre></div><h3 id="设置数据库权限"> 设置数据库权限 <a class="heading-link" href="#%e8%ae%be%e7%bd%ae%e6%95%b0%e6%8d%ae%e5%ba%93%e6%9d%83%e9%99%90"> <i class="fa-solid fa-link" aria-hidden="true" title="链接到标题"></i> <span class="sr-only">链接到标题</span> </a> </h3> <p>仅该用户和 admin 可以访问：</p>