https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/Recent content in 身份验证 on tgsHugozhhttps://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/login/Mon, 01 Jan 0001 00:00:00 +0000https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/login/<h1 id="tgs-login">tgs login<a class="anchor" href="#tgs-login">#</a></h1> <p>对 Telegram 进行身份验证。会话保存在本地，后续所有命令自动复用。</p> <h2 id="用法">用法<a class="anchor" href="#%e7%94%a8%e6%b3%95">#</a></h2> <pre tabindex="0"><code>tgs login [flags]</code></pre> <h2 id="参数">参数<a class="anchor" href="#%e5%8f%82%e6%95%b0">#</a></h2> <table> <thead> <tr> <th>Flag</th> <th>Short</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--type</code></td> <td><code>-T</code></td> <td><code>desktop</code></td> <td>Auth method: <code>desktop</code>, <code>code</code>, or <code>qr</code></td> </tr> <tr> <td><code>--desktop-dir</code></td> <td><code>-d</code></td> <td>(auto-detect)</td> <td>Path to Telegram Desktop tdata directory</td> </tr> <tr> <td><code>--passcode</code></td> <td></td> <td></td> <td>Telegram Desktop local passcode</td> </tr> <tr> <td><code>--phone</code></td> <td></td> <td></td> <td>Phone number for <code>code</code> method</td> </tr> <tr> <td><code>--code</code></td> <td></td> <td></td> <td>Verification code (for non-interactive login)</td> </tr> <tr> <td><code>--password</code></td> <td></td> <td></td> <td>2FA cloud password</td> </tr> <tr> <td><code>--profile</code></td> <td><code>-p</code></td> <td>(resolved)</td> <td>Profile name to authenticate into</td> </tr> </tbody> </table> <p>未设置 <code>--profile</code> 时的配置文件解析顺序：<code>TGS_PROFILE</code> 环境变量 → <code>.tgs.yaml</code> 文件 → <code>&quot;default&quot;</code>。</p>https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/logout/Mon, 01 Jan 0001 00:00:00 +0000https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/logout/<h1 id="tgs-logout">tgs logout<a class="anchor" href="#tgs-logout">#</a></h1> <p>在 Telegram 服务器上撤销当前会话，并清除本地会话数据。</p> <h2 id="用法">用法<a class="anchor" href="#%e7%94%a8%e6%b3%95">#</a></h2> <pre tabindex="0"><code>tgs logout [flags]</code></pre> <h2 id="参数">参数<a class="anchor" href="#%e5%8f%82%e6%95%b0">#</a></h2> <table> <thead> <tr> <th>Flag</th> <th>Short</th> <th>Default</th> <th>Description</th> </tr> </thead> <tbody> <tr> <td><code>--profile</code></td> <td><code>-p</code></td> <td>(resolved)</td> <td>Profile to log out from</td> </tr> </tbody> </table> <p>未设置 <code>--profile</code> 时的配置文件解析顺序：<code>TGS_PROFILE</code> 环境变量 → <code>.tgs.yaml</code> 文件 → <code>&quot;default&quot;</code>。</p> <h2 id="示例">示例<a class="anchor" href="#%e7%a4%ba%e4%be%8b">#</a></h2> <div class="highlight"><pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-bash" data-lang="bash"><span style="display:flex;"><span><span style="color:#7f848e"># Logout the current profile</span> </span></span><span style="display:flex;"><span>tgs <span style="color:#e5c07b">logout</span> </span></span><span style="display:flex;"><span> </span></span><span style="display:flex;"><span><span style="color:#7f848e"># Logout a specific profile</span> </span></span><span style="display:flex;"><span>tgs <span style="color:#e5c07b">logout</span> --profile work</span></span></code></pre></div> <h2 id="输出">输出<a class="anchor" href="#%e8%be%93%e5%87%ba">#</a></h2> <p><strong>JSON（默认）：</strong></p> <div class="highlight"><pre tabindex="0" style="color:#abb2bf;background-color:#282c34;-moz-tab-size:4;-o-tab-size:4;tab-size:4;-webkit-text-size-adjust:none;"><code class="language-json" data-lang="json"><span style="display:flex;"><span>{<span style="color:#e06c75">&#34;profile&#34;</span>:<span style="color:#98c379">&#34;default&#34;</span>,<span style="color:#e06c75">&#34;status&#34;</span>:<span style="color:#98c379">&#34;logged_out&#34;</span>}</span></span></code></pre></div><p><strong>文本（<code>--output text</code>）：</strong></p> <pre tabindex="0"><code>Logged out (profile: default)</code></pre><p>若配置文件未登录，命令以非零退出码结束并将错误写入 stderr。</p> <h2 id="说明">说明<a class="anchor" href="#%e8%af%b4%e6%98%8e">#</a></h2> <p>退出登录执行两个步骤：</p> <ol> <li>调用 Telegram API 撤销会话令牌（会话在 Telegram 服务器端失效）</li> <li>清除该配置文件的本地会话数据库</li> </ol> <p>退出后，必须重新运行 <code>tgs login</code> 才能继续使用该配置文件。</p> <h2 id="另请参阅">另请参阅<a class="anchor" href="#%e5%8f%a6%e8%af%b7%e5%8f%82%e9%98%85">#</a></h2> <ul> <li><a href="https://garenal1v3.github.io/tgs-cli/zh/reference/commands/auth/login/">tgs login</a></li> <li><a href="https://garenal1v3.github.io/tgs-cli/zh/getting-started/authentication/">身份验证指南</a></li> </ul>