import{_ as s,c as a,o as l,ah as e}from"./chunks/framework.BJEpWshW.js";const c=JSON.parse('{"title":"首次使用","description":"","frontmatter":{},"headers":[],"relativePath":"guide/first-use.md","filePath":"guide/first-use.md"}'),t={name:"guide/first-use.md"};function n(h,i,r,k,p,o){return l(),a("div",null,[...i[0]||(i[0]=[e(`<h1 id="首次使用" tabindex="-1">首次使用 <a class="header-anchor" href="#首次使用" aria-label="Permalink to “首次使用”">​</a></h1><p>首次使用 WebAI2API 时，需要完成登录初始化才能正常使用。</p><h2 id="登录模式" tabindex="-1">登录模式 <a class="header-anchor" href="#登录模式" aria-label="Permalink to “登录模式”">​</a></h2><h3 id="启动登录模式" tabindex="-1">启动登录模式 <a class="header-anchor" href="#启动登录模式" aria-label="Permalink to “启动登录模式”">​</a></h3><p>登录模式会强制关闭无头模式</p><div class="language-bash"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 启动第一个 Worker 进行登录</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> start</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -login</span></span>
<span class="line"></span>
<span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 启动指定 Worker 进行登录</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> start</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -login=workerName</span></span></code></pre></div><h3 id="linux-用户特殊说明" tabindex="-1">Linux 用户特殊说明 <a class="header-anchor" href="#linux-用户特殊说明" aria-label="Permalink to “Linux 用户特殊说明”">​</a></h3><p>Linux 服务器用户可以使用 Xvfb + VNC 方式：</p><div class="language-bash"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> start</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -xvfb</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -vnc</span></span></code></pre></div><p>然后通过 VNC 客户端连接 <code>:5900</code> 端口进行操作（也可使用 WebUI 中的虚拟显示器板块）</p><h2 id="初始化步骤" tabindex="-1">初始化步骤 <a class="header-anchor" href="#初始化步骤" aria-label="Permalink to “初始化步骤”">​</a></h2><ol><li><p><strong>登录账号</strong></p><ul><li>Linux 用户使用 <code>npm start -- -xvfb -vnc</code> 启动程序，然后使用 WebUI 或者第三方工具连接 VNC</li><li>在打开的浏览器中登录相应平台的账号</li><li>例如：Google 账号用于 Gemini，GitHub 账号用于 LMArena</li></ul></li><li><p><strong>完成验证</strong></p><ul><li>在输入框发送任意消息</li><li>触发并完成 CloudFlare/reCAPTCHA 验证</li><li>同意服务条款</li></ul></li><li><p><strong>验证成功</strong></p><ul><li>确认可以正常发送消息和接收回复</li><li>关闭浏览器或按 <code>Ctrl+C</code> 退出登录模式</li></ul></li></ol><div class="tip custom-block"><p class="custom-block-title">运行建议</p><ul><li>初始化完成后可使用无头模式运行，为降低风控风险，<strong>强烈建议长期保持非无头模式运行</strong>。</li><li><strong>WebUI 和 VNC 传输过程均未加密，若在公网环境运行请走 SSH 隧道或者使用 Caddy/Nginx 为 WebUI 添加 HTTPS 连接</strong><div class="language-bash"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># SSH隧道方法：在本地终端运行，将服务器 5900 端口映射到本地</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">ssh</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -L</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> 5900:127.0.0.1:5900</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> root@服务器IP</span></span></code></pre></div></li></ul></div><h2 id="多-worker-登录" tabindex="-1">多 Worker 登录 <a class="header-anchor" href="#多-worker-登录" aria-label="Permalink to “多 Worker 登录”">​</a></h2><p>如果配置了多个 Worker，需要分别为每个 Worker 完成登录：</p><div class="language-bash"><button title="Copy Code" class="copy"></button><span class="lang">bash</span><pre class="shiki shiki-themes github-light github-dark" style="--shiki-light:#24292e;--shiki-dark:#e1e4e8;--shiki-light-bg:#fff;--shiki-dark-bg:#24292e;" tabindex="0" dir="ltr"><code><span class="line"><span style="--shiki-light:#6A737D;--shiki-dark:#6A737D;"># 依次登录各个 Worker</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> start</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -login=worker1</span></span>
<span class="line"><span style="--shiki-light:#6F42C1;--shiki-dark:#B392F0;">npm</span><span style="--shiki-light:#032F62;--shiki-dark:#9ECBFF;"> start</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> --</span><span style="--shiki-light:#005CC5;--shiki-dark:#79B8FF;"> -login=worker2</span></span></code></pre></div><div class="info custom-block"><p class="custom-block-title">共享登录状态</p><p>同一 Instance（浏览器实例）下的多个 Worker 共享登录状态。如果使用 Google OAuth 等统一登录方式，只需登录一次即可。</p></div><h2 id="webui-登录模式" tabindex="-1">WebUI 登录模式 <a class="header-anchor" href="#webui-登录模式" aria-label="Permalink to “WebUI 登录模式”">​</a></h2><p>服务运行后，也可以通过 WebUI 切换到登录模式：</p><ol><li>访问 <a href="http://localhost:3000" target="_blank" rel="noreferrer">http://localhost:3000</a></li><li>进入「系统管理」页面</li><li>点击「重启」按钮的下拉箭头</li><li>选择「登录模式重启」或指定 Worker 登录</li></ol><h2 id="下一步" tabindex="-1">下一步 <a class="header-anchor" href="#下一步" aria-label="Permalink to “下一步”">​</a></h2><p>登录完成后，请阅读以下内容：</p><ul><li><a href="/config/overview.html">配置文件</a> - 了解完整配置选项</li><li><a href="/api/overview.html">API 参考</a> - 开始使用 API</li></ul>`,23)])])}const g=s(t,[["render",n]]);export{c as __pageData,g as default};
