<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
  <id>https://blog.qtfyu.top/</id>
  <title type="text">倾听风雨</title>
  <subtitle type="text">回家啦~</subtitle>
  <updated>2026-11-09T00:00:00.000Z</updated>
  <author><name>倾听风雨</name></author>
  <link rel="alternate" href="https://blog.qtfyu.top/"/>
  <link rel="self" href="https://blog.qtfyu.top/atom.xml"/>
  <generator uri="https://github.com/CuteLeaf/Firefly">Firefly</generator>
    <entry>
      <id>https://blog.qtfyu.top/posts/tiny-thief-android-guide/</id>
      <title type="text">小小盗贼 Tiny Thief 安卓版完整资源指南</title>
      <published>2026-08-25T00:00:00.000Z</published>
      <updated>2026-08-25T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/tiny-thief-android-guide/"/>
      <summary type="text">小小盗贼安卓版全版本下载与安装指南，涵盖原版APK、兼容版、免验证版及OBB数据包详解。</summary>
      <content type="html"><![CDATA[<blockquote><p>本文档面向希望在安卓设备上体验《小小盗贼》的玩家，提供全版本APK与OBB数据包的详细说明及安装指引。
<strong>适用系统：</strong> Android 4.0+ / Android 5.1+ / Android 8.0+
<strong>适用平台：</strong> 安卓手机 / 平板</p></blockquote>
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E6%B8%B8%E6%88%8F%E7%AE%80%E4%BB%8B">游戏简介</a></li>
<li><a href="#2-%E7%89%88%E6%9C%AC%E8%AF%B4%E6%98%8E%E4%B8%8E%E6%96%87%E4%BB%B6%E6%B8%85%E5%8D%95">版本说明与文件清单</a></li>
<li><a href="#3-%E5%AE%89%E8%A3%85%E5%89%8D%E5%87%86%E5%A4%87">安装前准备</a></li>
<li><a href="#4-%E5%90%84%E7%89%88%E6%9C%AC%E5%AE%89%E8%A3%85%E6%96%B9%E6%B3%95">各版本安装方法</a></li>
<li><a href="#5-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E4%B8%8E%E8%A7%A3%E5%86%B3">常见问题与解决</a></li>
<li><a href="#6-%E4%B8%8B%E8%BD%BD%E9%93%BE%E6%8E%A5">下载链接</a></li>
</ol><hr /></section>
<section><h2>1. 游戏简介<a href="#1-游戏简介"><span>#</span></a></h2><img src="/downloads/tinythief/tiny128x128.png" alt="小小盗贼游戏图标" width="200" /><p>《小小盗贼》（Tiny Thief，又名小贼物语）是由西班牙独立工作室 <strong>5 Ants</strong> 开发、<strong>Rovio Stars</strong> 发行的一款潜行类益智解谜游戏，于2013年7月11日正式登陆Android与iOS平台。</p><p>游戏背景设定在中世纪，玩家将扮演一位身材小巧、头戴绿帽的可爱侠盗，在贪婪与腐败肆虐的世界中劫富济贫。你需要利用场景中的各种道具，躲避守卫视线、甩开猎狗追踪，完成六次史诗般的冒险任务，从海盗船到魔王巢穴，一路拯救公主与王国。</p><div><div><div></div><div>提示</div></div><div><p>本作已下架多年，目前官方渠道无法下载。本文档提供的均为历史版本资源，仅供怀旧与收藏。（当然为了你们想玩或者纪念提供了神秘版本）</p></div></div><section><h3>游戏特色<a href="#游戏特色"><span>#</span></a></h3>

<table><thead><tr><th>特色</th><th>说明</th></tr></thead><tbody><tr><td>点击式操控</td><td>单指点击即可完成移动、互动、拾取全部操作</td></tr><tr><td>6大章节</td><td>包含教学关在内共30余个精心设计的关卡</td></tr><tr><td>三星评价</td><td>每关包含任务目标、隐藏宝藏、宠物雪貂三项收集</td></tr><tr><td>50+NPC</td><td>与丰富多样的角色互动，触发意想不到的剧情</td></tr><tr><td>100+宝物</td><td>散落在各关卡中的隐藏物品等待发掘</td></tr><tr><td>清新画风</td><td>2D手绘卡通风格，配乐轻松诙谐</td></tr></tbody></table><hr /></section></section>
<section><h2>2. 版本说明与文件清单<a href="#2-版本说明与文件清单"><span>#</span></a></h2><p>本文档提供以下5个文件，覆盖不同使用场景：</p>

<table><thead><tr><th>文件名</th><th>类型</th><th>大小</th><th>适用场景</th><th>版本</th></tr></thead><tbody><tr><td><code>com.roviostars.tinythief_1.2.1b-APK_Award-Mod.apk</code></td><td>APK</td><td>约61.9MB</td><td>自带资源包，安装即玩</td><td>初始</td></tr><tr><td><code>main.57.com.roviostars.tinythief.obb</code></td><td>OBB</td><td>约17.3MB</td><td>配合原版APK使用的数据包</td><td>初始</td></tr><tr><td><code>tinythief_1.2.1b_解除验证_原版安卓5.1.apk</code></td><td>APK</td><td>约62.0MB</td><td>去验证版，仅限安卓5.1</td><td>破解</td></tr><tr><td><code>tinythief_1.2.1b_支持高版本安卓.apk</code></td><td>APK</td><td>约62.0MB</td><td>兼容版，支持安卓8.0+</td><td>破解</td></tr><tr><td><code>tiny-thief-1-2-1-en-android.apk</code></td><td>APK</td><td>约45.3MB</td><td>最原始的原版安装包</td><td>初始</td></tr></tbody></table><hr /></section>
<section><h2>3. 安装前准备<a href="#3-安装前准备"><span>#</span></a></h2><section><h3>3.1 开启未知来源安装<a href="#31-开启未知来源安装"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>设置</span><span> </span><span>→</span><span> </span><span>安全</span><span> </span><span>→</span><span> </span><span>未知来源</span><span> </span><span>→</span><span> </span><span>允许</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p>安卓8.0+系统需在安装时单独授予浏览器/文件管理器”安装未知应用”权限。</p></div></div></section><section><h3>3.2 确认系统架构<a href="#32-确认系统架构"><span>#</span></a></h3><p>本游戏为纯ARMv7应用，主流安卓设备均可运行。若使用安卓模拟器，请选择ARM兼容模式。</p></section><section><h3>3.3 存储空间<a href="#33-存储空间"><span>#</span></a></h3><p>确保设备剩余存储空间大于 <strong>150MB</strong>，以容纳APK安装及运行缓存。</p><hr /></section></section>
<section><h2>4. 各版本安装方法<a href="#4-各版本安装方法"><span>#</span></a></h2><section><h3>4.1 自带资源包版（推荐新手）<a href="#41-自带资源包版推荐新手"><span>#</span></a></h3><p><strong>文件：</strong> <code>com.roviostars.tinythief_1.2.1b-APK_Award-Mod.apk</code></p><p>此版本已将OBB数据包内置到APK中，无需手动放置额外文件，安装完成后直接运行即可。</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 直接安装APK</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>建议</div></div><div><p>如果你不想折腾OBB路径，直接选这个版本。文件体积稍大，但最省心。</p></div></div><hr /></section><section><h3>4.2 原版APK + OBB数据包（经典组合）<a href="#42-原版apk--obb数据包经典组合"><span>#</span></a></h3><p><strong>文件：</strong> <code>tiny-thief-1-2-1-en-android.apk</code> + <code>main.57.com.roviostars.tinythief.obb</code></p><p>这是游戏最原始的发行形态。APK仅包含程序本体，游戏资源需通过OBB数据包加载。</p><p><strong>安装步骤：</strong></p><div><figure><figcaption><span>/sdcard/Android/obb/com.roviostars.tinythief/</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 第一步：安装APK（先不要打开游戏）</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span># 第二步：将OBB文件放入指定目录</span></div></div><div><div><div>4</div></div><div><span># 最终完整路径：</span></div></div><div><div><div>5</div></div><div><span>/sdcard/Android/obb/com.roviostars.tinythief/main.57.com.roviostars.tinythief.obb</span></div></div><div><div><div>6</div></div><div><span># 或</span></div></div><div><div><div>7</div></div><div><span>/Android/obb/com.roviostars.tinythief/main.57.com.roviostars.tinythief.obb</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>重要</div></div><div><p>文件夹路径必须完全一致，包括大小写。若 <code>obb</code> 或 <code>com.roviostars.tinythief</code> 文件夹不存在，请手动创建。</p></div></div><hr /></section><section><h3>4.3 解除验证版（安卓5.1专用）<a href="#43-解除验证版安卓51专用"><span>#</span></a></h3><p><strong>文件：</strong> <code>tinythief_1.2.1b_解除验证_原版安卓5.1.apk</code></p><p>此版本去除了Google Play正版验证，但保留了原版安卓5.1的兼容性配置，<strong>仅推荐在安卓5.1设备上使用</strong>。</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 直接安装即可</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p>在安卓6.0+设备上运行此版本可能出现闪退、黑屏或无法启动的情况。高版本系统请使用下方的兼容版。</p></div></div><hr /></section><section><h3>4.4 高版本兼容版（现代设备首选）<a href="#44-高版本兼容版现代设备首选"><span>#</span></a></h3><p><strong>文件：</strong> <code>tinythief_1.2.1b_支持高版本安卓.apk</code></p><p>针对安卓8.0、安卓10、安卓12乃至更高版本系统做了兼容性处理，解决了高版本Android的API适配问题。</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 直接安装即可</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>建议</div></div><div><p>如果你使用的是安卓8.0及以上设备，优先选择此版本。若仍有问题，可尝试配合OBB数据包使用。</p></div></div><hr /></section><section><h3>4.5 版本选择速查<a href="#45-版本选择速查"><span>#</span></a></h3>

<table><thead><tr><th>你的设备情况</th><th>推荐版本</th><th>状态</th><th>描述</th></tr></thead><tbody><tr><td>安卓5.1</td><td>解除验证版 或 自带资源包版</td><td>可运行</td><td>去除了服务器验证</td></tr><tr><td>安卓6.0 - 7.1</td><td>自带资源包版 或 原版+OBB</td><td>不可运行</td><td>服务器已离线</td></tr><tr><td>安卓8.0+</td><td>高版本兼容版 或 自带资源包版</td><td>可运行</td><td>去除了服务器验证，并且支持高版本安卓</td></tr><tr><td>不想折腾OBB</td><td>自带资源包版</td><td>不可运行</td><td>服务器已离线</td></tr><tr><td>追求原汁原味</td><td>原版APK + OBB</td><td>不可运行</td><td>服务器已离线</td></tr></tbody></table><hr /></section></section>
<section><h2>5. 常见问题与解决<a href="#5-常见问题与解决"><span>#</span></a></h2><section><h3>5.1 安装后闪退/黑屏<a href="#51-安装后闪退黑屏"><span>#</span></a></h3>

<table><thead><tr><th>原因</th><th>解决</th></tr></thead><tbody><tr><td>系统版本不兼容</td><td>安卓5.1设备用解除验证版，安卓8.0+用兼容版</td></tr><tr><td>缺少OBB数据包</td><td>检查 <code>/Android/obb/com.roviostars.tinythief/</code> 路径下是否有obb文件</td></tr><tr><td>存储权限未授予</td><td>前往设置 → 应用 → 小小盗贼 → 权限 → 开启存储权限</td></tr></tbody></table></section><section><h3>5.2 提示”需要下载额外数据”<a href="#52-提示需要下载额外数据"><span>#</span></a></h3><p>说明你安装的是原版APK但OBB文件位置放错了。请严格按照以下路径检查：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>/sdcard/Android/obb/com.roviostars.tinythief/main.57.com.roviostars.tinythief.obb</span></div></div><div><div><div>2</div></div><div><span># 或</span></div></div><div><div><div>3</div></div><div><span>/Android/obb/com.roviostars.tinythief/main.57.com.roviostars.tinythief.obb</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>提示</div></div><div><p>部分文件管理器显示的 <code>内部存储</code> 即对应 <code>/sdcard/</code> 路径。</p></div></div></section><section><h3>5.3 游戏没有声音<a href="#53-游戏没有声音"><span>#</span></a></h3><p>检查设备是否处于静音模式，或尝试在游戏设置中调整音量。部分高版本安卓需关闭”勿扰模式”。</p></section><section><h3>5.4 如何卸载干净<a href="#54-如何卸载干净"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 卸载APK后，手动删除残留数据</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>/sdcard/Android/obb/com.roviostars.tinythief/</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>/sdcard/Android/data/com.roviostars.tinythief/</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>6. 下载链接<a href="#6-下载链接"><span>#</span></a></h2><div><div><div></div><div>游戏资源下载</div></div><div><p><a href="/downloads/tinythief/com.roviostars.tinythief_1.2.1b-APK_Award-Mod.apk">自带资源包版（约61.9MB）</a>
<br />
<a href="/downloads/tinythief/main.57.com.roviostars.tinythief.obb">OBB数据包（约17.3MB）</a>
<br />
<a href="/downloads/tinythief/tinythief_1.2.1b_解除验证_原版安卓5.1.apk">（推荐）解除验证版 安卓5.1（约62.0MB）</a>
<br />
<a href="/downloads/tinythief/tinythief_1.2.1b_支持高版本安卓.apk">（推荐）高版本兼容版（约62.0MB）</a>
<br />
<a href="/downloads/tinythief/tiny-thief-1-2-1-en-android.apk">原版APK（约45.3MB）</a></p></div></div><div><div><div></div><div>警告</div></div><div><p>如果侵权请联系站长删除。</p></div></div><hr /><blockquote><p><strong>文档版本：</strong> 2026-08-25
<strong>适用系统：</strong> Android 4.0+ / Android 5.1+ / Android 8.0+
<strong>适用平台：</strong> 安卓手机 / 平板</p></blockquote></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/linux-acl-complete-guide/</id>
      <title type="text">Linux ACL 访问控制列表完整使用指南</title>
      <published>2026-08-12T00:00:00.000Z</published>
      <updated>2026-08-12T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/linux-acl-complete-guide/"/>
      <summary type="text">Linux ACL 从入门到实战，涵盖安装、授权、查看、删除及恢复默认权限的完整操作指南。</summary>
      <content type="html"><![CDATA[<blockquote><p>本文档面向 Linux 服务器运维人员，讲解 ACL 扩展权限的安装、配置、查看与清除。
<strong>适用系统：</strong> Debian 12 / Ubuntu 20.04+ / CentOS 7+
<strong>适用平台：</strong> 云服务器 / 本地虚拟机</p></blockquote>
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-acl-%E6%98%AF%E4%BB%80%E4%B9%88">ACL 是什么</a></li>
<li><a href="#2-%E5%AE%89%E8%A3%85-acl">安装 ACL</a></li>
<li><a href="#3-%E6%A0%B8%E5%BF%83%E5%91%BD%E4%BB%A4%E9%80%9F%E8%A7%88">核心命令速览</a></li>
<li><a href="#4-setfacl-%E5%8F%82%E6%95%B0%E8%AF%A6%E8%A7%A3">setfacl 参数详解</a></li>
<li><a href="#5-%E6%9D%83%E9%99%90%E8%AE%BE%E7%BD%AE%E6%A0%BC%E5%BC%8F">权限设置格式</a></li>
<li><a href="#6-%E5%B8%B8%E7%94%A8%E6%93%8D%E4%BD%9C%E7%A4%BA%E4%BE%8B">常用操作示例</a></li>
<li><a href="#7-%E5%AE%8C%E6%95%B4%E5%AE%9E%E6%88%98%E5%88%9B%E5%BB%BA%E9%83%A8%E7%BD%B2%E7%94%A8%E6%88%B7">完整实战：创建部署用户</a></li>
<li><a href="#8-%E6%B8%85%E9%99%A4-acl-%E6%81%A2%E5%A4%8D%E9%BB%98%E8%AE%A4%E9%87%8D%E7%82%B9">清除 ACL 恢复默认（重点）</a></li>
<li><a href="#9-%E9%85%8D%E5%90%88-ssh-%E4%BD%BF%E7%94%A8">配合 SSH 使用</a></li>
<li><a href="#10-%E6%B3%A8%E6%84%8F%E4%BA%8B%E9%A1%B9">注意事项</a></li>
<li><a href="#11-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98">常见问题</a></li>
<li><a href="#12-%E4%B8%80%E9%94%AE%E8%AE%BE%E7%BD%AE%E8%84%9A%E6%9C%AC">一键设置脚本</a></li>
<li><a href="#13-%E5%91%BD%E4%BB%A4%E9%80%9F%E6%9F%A5%E8%A1%A8">命令速查表</a></li>
</ol><hr /></section>
<section><h2>1. ACL 是什么<a href="#1-acl-是什么"><span>#</span></a></h2><p>传统 Linux 权限只能按三类控制：所有者、所属组、其他人。</p><p>ACL（Access Control List）可以精确到<strong>单个用户</strong>或<strong>单个组</strong>，实现更细粒度的权限管理，且不影响原有权限体系。</p><div><div><div></div><div>提示</div></div><div><p>没有设置过 ACL 的文件，本质上和传统权限文件一样，只是 <code>getfacl</code> 会把基本权限也展示出来。</p></div></div><hr /></section>
<section><h2>2. 安装 ACL<a href="#2-安装-acl"><span>#</span></a></h2><section><h3>Debian / Ubuntu<a href="#debian--ubuntu"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>acl</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>CentOS / RHEL / Rocky<a href="#centos--rhel--rocky"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>yum</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>acl</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span># 或</span></div></div><div><div><div>4</div></div><div><span>sudo</span><span> </span><span>dnf</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>acl</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>验证安装<a href="#验证安装"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>getfacl</span><span> </span><span>--version</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>3. 核心命令速览<a href="#3-核心命令速览"><span>#</span></a></h2>

<table><thead><tr><th>命令</th><th>全称</th><th>作用</th></tr></thead><tbody><tr><td><code>setfacl</code></td><td>Set File Access Control List</td><td>设置 ACL 权限</td></tr><tr><td><code>getfacl</code></td><td>Get File Access Control List</td><td>查看 ACL 权限</td></tr></tbody></table><hr /></section>
<section><h2>4. setfacl 参数详解<a href="#4-setfacl-参数详解"><span>#</span></a></h2>

<table><thead><tr><th>参数</th><th>含义</th><th>说明</th></tr></thead><tbody><tr><td><code>-m</code></td><td>修改 / 添加</td><td>修改或添加一条 ACL 规则</td></tr><tr><td><code>-x</code></td><td>删除</td><td>删除指定用户/组的 ACL 规则</td></tr><tr><td><code>-b</code></td><td>清空所有 ACL</td><td><strong>删除所有 ACL 条目，只保留基本权限</strong></td></tr><tr><td><code>-k</code></td><td>删除默认 ACL</td><td>只删除 default 规则，保留当前规则</td></tr><tr><td><code>-R</code></td><td>递归</td><td>对目录及所有子内容生效</td></tr><tr><td><code>-d</code></td><td>默认 ACL</td><td>新创建的文件/目录自动继承</td></tr></tbody></table><div><div><div></div><div>重要</div></div><div><p><code>-b</code> 和 <code>-k</code> 的区别后面会详细讲，这是很多人混淆的地方。</p></div></div><hr /></section>
<section><h2>5. 权限设置格式<a href="#5-权限设置格式"><span>#</span></a></h2><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>u:用户名:权限    # 给用户设置权限</span></div></div><div><div><div>2</div></div><div><span>g:组名:权限      # 给组设置权限</span></div></div><div><div><div>3</div></div><div><span>o::权限          # 给其他用户设置权限</span></div></div><div><div><div>4</div></div><div><span>m::权限          # 设置有效权限掩码</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>权限值：<code>r</code> (读)、<code>w</code> (写)、<code>x</code> (执行)、<code>-</code> (无权限)</p><hr /></section>
<section><h2>6. 常用操作示例<a href="#6-常用操作示例"><span>#</span></a></h2><section><h3>6.1 给用户添加权限<a href="#61-给用户添加权限"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 给用户 blogdeploy 添加 /opt/blog 目录的读写执行权限</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/blog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 给多个用户分别添加权限</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-m</span><span> </span><span>u:alice:rwx</span><span> </span><span>/opt/blog</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-m</span><span> </span><span>u:bob:rx</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.2 递归设置权限<a href="#62-递归设置权限"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 递归给 blogdeploy 授权（当前已有文件/目录）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.3 设置默认 ACL（新文件自动继承）<a href="#63-设置默认-acl新文件自动继承"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 默认 ACL：以后在 /opt/blog 下创建的新文件/目录自动继承权限</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-d</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.4 同时设置当前权限和默认权限（推荐做法）<a href="#64-同时设置当前权限和默认权限推荐做法"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 第一步：递归授权已有内容</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/blog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 第二步：设置默认 ACL，新文件自动继承</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-d</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.5 查看 ACL 权限<a href="#65-查看-acl-权限"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看单个文件/目录的 ACL</span></div></div><div><div><div>2</div></div><div><span>getfacl</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>输出示例：</strong></p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span># file: opt/blog</span></div></div><div><div><div>2</div></div><div><span># owner: root</span></div></div><div><div><div>3</div></div><div><span># group: root</span></div></div><div><div><div>4</div></div><div><span>user::rwx</span></div></div><div><div><div>5</div></div><div><span>user:blogdeploy:rwx      ← 自定义用户权限</span></div></div><div><div><div>6</div></div><div><span>group::r-x</span></div></div><div><div><div>7</div></div><div><span>mask::rwx</span></div></div><div><div><div>8</div></div><div><span>other::r-x</span></div></div><div><div><div>9</div></div><div><span>default:user::rwx</span></div></div><div><div><div>10</div></div><div><span>default:user:blogdeploy:rwx   ← 默认继承权限</span></div></div><div><div><div>11</div></div><div><span>default:group::r-x</span></div></div><div><div><div>12</div></div><div><span>default:mask::rwx</span></div></div><div><div><div>13</div></div><div><span>default:other::r-x</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.6 删除单个用户的 ACL<a href="#66-删除单个用户的-acl"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 删除 blogdeploy 的 ACL 权限</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-x</span><span> </span><span>u:blogdeploy</span><span> </span><span>/opt/blog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 递归删除</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-x</span><span> </span><span>u:blogdeploy</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>7. 完整实战：创建部署用户<a href="#7-完整实战创建部署用户"><span>#</span></a></h2><p>场景：创建 <code>blogdeploy</code> 用户，只能操作 <code>/opt/1panel/www/sites/blog</code> 目录。</p><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. 创建用户</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>useradd</span><span> </span><span>-m</span><span> </span><span>-s</span><span> </span><span>/bin/bash</span><span> </span><span>blogdeploy</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 2. 设置密码</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>passwd</span><span> </span><span>blogdeploy</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 3. 确保 ACL 已安装</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>acl</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 4. 设置 ACL 权限（递归 + 默认继承）</span></div></div><div><div><div>11</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/1panel/www/sites/blog</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-d</span><span> </span><span>-m</span><span> </span><span>u:blogdeploy:rwx</span><span> </span><span>/opt/1panel/www/sites/blog</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span># 5. 验证</span></div></div><div><div><div>16</div></div><div><span>getfacl</span><span> </span><span>/opt/1panel/www/sites/blog</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span># 6. 测试登录</span></div></div><div><div><div>19</div></div><div><span>su</span><span> </span><span>-</span><span> </span><span>blogdeploy</span></div></div><div><div><div>20</div></div><div>
</div></div><div><div><div>21</div></div><div><span>cd</span><span> </span><span>/opt/1panel/www/sites/blog</span></div></div><div><div><div>22</div></div><div>
</div></div><div><div><div>23</div></div><div><span>touch</span><span> </span><span>test.txt</span></div></div><div><div><div>24</div></div><div>
</div></div><div><div><div>25</div></div><div><span>rm</span><span> </span><span>test.txt</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>8. 清除 ACL 恢复默认（重点）<a href="#8-清除-acl-恢复默认重点"><span>#</span></a></h2><p>这是最容易搞混的部分，分三种情况讲清楚。</p><section><h3>8.1 ACL 的默认状态是什么？<a href="#81-acl-的默认状态是什么"><span>#</span></a></h3><p><strong>没有设置过 ACL 的文件</strong>，<code>getfacl</code> 输出长这样：</p><div><figure><figcaption><span>somefile.txt</span></figcaption><pre><code><div><div><div>1</div></div><div><span># owner: root</span></div></div><div><div><div>2</div></div><div><span># group: root</span></div></div><div><div><div>3</div></div><div><span>user::rw-</span></div></div><div><div><div>4</div></div><div><span>group::r--</span></div></div><div><div><div>5</div></div><div><span>other::r--</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>这就是 ACL 的<strong>默认状态</strong> —— 和传统 <code>ls -l</code> 看到的基本权限完全一致，没有任何额外的 <code>user:xxx</code> 或 <code>default:</code> 条目。</p></section><section><h3>8.2 彻底删除所有 ACL 条目（恢复初始状态）<a href="#82-彻底删除所有-acl-条目恢复初始状态"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 删除所有 ACL 条目，只保留基本权限</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-b</span><span> </span><span>/opt/blog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 递归删除整个目录树的所有 ACL</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-b</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>重要</div></div><div><p><code>-b</code> 会删除所有自定义 ACL 条目（包括 <code>user:xxx</code> 和 <code>default:</code>），但<strong>保留</strong>文件原有的 <code>user::</code>、<code>group::</code>、<code>other::</code> 基本权限。
执行后文件就回到了”从未设置过 ACL”的状态。</p></div></div></section><section><h3>8.3 只删除默认 ACL，保留当前权限<a href="#83-只删除默认-acl保留当前权限"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 只删除 default 规则，不影响已设置的当前权限</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-k</span><span> </span><span>/opt/blog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 递归删除</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-k</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>提示</div></div><div><p>适用于：你已经给目录设好了当前权限，但不想让新文件自动继承，只想取消”默认继承”功能。</p></div></div></section><section><h3>8.4 彻底归零：ACL + 基本权限全部重置<a href="#84-彻底归零acl--基本权限全部重置"><span>#</span></a></h3><p>如果你想把文件权限彻底恢复到”刚创建”的状态（比如 <code>644</code> 或 <code>755</code>）：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 第一步：删除所有 ACL</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-b</span><span> </span><span>/opt/blog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 第二步：用 chmod 重置基本权限</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>chmod</span><span> </span><span>-R</span><span> </span><span>755</span><span> </span><span>/opt/blog</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 第三步：改回正确的所有者和组</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>chown</span><span> </span><span>-R</span><span> </span><span>root:root</span><span> </span><span>/opt/blog</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p>以上三步是<strong>不可逆的</strong>，执行前请确认你真的想清空所有权限设置。</p></div></div></section><section><h3>8.5 三种清除方式对比<a href="#85-三种清除方式对比"><span>#</span></a></h3>

<table><thead><tr><th>命令</th><th>作用</th><th>使用场景</th></tr></thead><tbody><tr><td><code>setfacl -x u:用户名 路径</code></td><td>删除某个用户的 ACL</td><td>只移除特定用户权限</td></tr><tr><td><code>setfacl -k 路径</code></td><td>删除默认 ACL</td><td>取消新文件自动继承</td></tr><tr><td><code>setfacl -b 路径</code></td><td>删除所有 ACL 条目</td><td><strong>恢复默认状态，最常用</strong></td></tr><tr><td><code>setfacl -b</code> + <code>chmod</code></td><td>ACL + 基本权限全重置</td><td>彻底归零，从头开始</td></tr></tbody></table><hr /></section></section>
<section><h2>9. 配合 SSH 使用<a href="#9-配合-ssh-使用"><span>#</span></a></h2><p>允许密码登录：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>nano</span><span> </span><span>/etc/ssh/sshd_config</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>确保配置项：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>PasswordAuthentication yes</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>重启 SSH：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>restart</span><span> </span><span>ssh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>重要</div></div><div><p>Debian/Ubuntu 上 SSH 服务名是 <code>ssh</code>，不是 <code>sshd</code>。<code>systemctl restart sshd</code> 在某些系统上可能不生效。</p></div></div><p>Windows 连接测试：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh</span><span> </span><span>blogdeploy@服务器IP</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>10. 注意事项<a href="#10-注意事项"><span>#</span></a></h2>

<table><thead><tr><th>注意点</th><th>说明</th></tr></thead><tbody><tr><td>备份目录也要授权</td><td>如果备份到 <code>blog-backup</code>，也要给 <code>blogdeploy</code> 授权</td></tr><tr><td><code>chmod</code> 可能影响 ACL</td><td><code>chmod</code> 会修改 ACL 的 mask，可能影响有效权限。建议用 <code>setfacl</code> 管理权限</td></tr><tr><td>文件系统支持</td><td>ext4、xfs、btrfs 都支持 ACL，fat32 不支持</td></tr><tr><td>挂载选项</td><td>确保挂载时启用了 ACL：<code>mount | grep acl</code></td></tr></tbody></table><hr /></section>
<section><h2>11. 常见问题<a href="#11-常见问题"><span>#</span></a></h2><section><h3>Q1: setfacl 提示 “Operation not supported”<a href="#q1-setfacl-提示-operation-not-supported"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 检查文件系统是否启用 ACL</span></div></div><div><div><div>2</div></div><div><span>mount</span><span> | </span><span>grep</span><span> </span><span>" / "</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 如果没有 acl，编辑 /etc/fstab 添加 acl 选项，然后重新挂载</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>Q2: 用户能看到其他目录吗？<a href="#q2-用户能看到其他目录吗"><span>#</span></a></h3><p>ACL 只控制特定目录的权限。用户仍然可以 <code>cd</code> 到 <code>/etc</code>，但只能看有权限的文件。</p><p>如需严格限制，考虑 <code>chroot</code> 或容器方案。</p></section><section><h3>Q3: 如何查看某个用户有哪些 ACL 权限？<a href="#q3-如何查看某个用户有哪些-acl-权限"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看所有带 ACL 的文件</span></div></div><div><div><div>2</div></div><div><span>getfacl</span><span> </span><span>-R</span><span> </span><span>/opt/1panel/www/sites/blog</span><span> | </span><span>grep</span><span> </span><span>"user:blogdeploy"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>12. 一键设置脚本<a href="#12-一键设置脚本"><span>#</span></a></h2><div><div><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>#!/bin/bash</span></div></div><div><div><div>2</div></div><div><span>USERNAME</span><span>=</span><span>"blogdeploy"</span></div></div><div><div><div>3</div></div><div><span>TARGET_DIR</span><span>=</span><span>"/opt/1panel/www/sites/blog"</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>echo</span><span> </span><span>"=== 创建用户并设置 ACL ==="</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 创建用户</span></div></div><div><div><div>8</div></div><div><span>if</span><span> ! </span><span>id</span><span> </span><span>"</span><span>$USERNAME</span><span>"</span><span> &amp;&gt;/dev/null; </span><span>then</span></div></div><div><div><div>9</div></div><div><span>    </span><span>sudo</span><span> </span><span>useradd</span><span> </span><span>-m</span><span> </span><span>-s</span><span> </span><span>/bin/bash</span><span> </span><span>"</span><span>$USERNAME</span><span>"</span></div></div><div><div><div>10</div></div><div><span>    </span><span>echo</span><span> </span><span>"✅ 用户 </span><span>$USERNAME</span><span> 已创建"</span></div></div><div><div><div>11</div></div><div><span>else</span></div></div><div><div><div>12</div></div><div><span>    </span><span>echo</span><span> </span><span>"⚠️ 用户已存在"</span></div></div><div><div><div>13</div></div><div><span>fi</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span># 设置密码</span></div></div><div><div><div>16</div></div><div><span>echo</span><span> </span><span>"🔑 设置密码："</span></div></div><div><div><div>17</div></div><div><span>sudo</span><span> </span><span>passwd</span><span> </span><span>"</span><span>$USERNAME</span><span>"</span></div></div><div><div><div>18</div></div><div>
</div></div><div><div><div>19</div></div><div><span># 安装 ACL</span></div></div><div><div><div>20</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>acl</span><span> 2&gt;</span><span>/dev/null</span><span> || </span><span>sudo</span><span> </span><span>yum</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>acl</span><span> 2&gt;</span><span>/dev/null</span></div></div><div><div><div>21</div></div><div>
</div></div><div><div><div>22</div></div><div><span># 设置权限</span></div></div><div><div><div>23</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-m</span><span> </span><span>u:"</span><span>$USERNAME</span><span>":rwx</span><span> </span><span>"</span><span>$TARGET_DIR</span><span>"</span></div></div><div><div><div>24</div></div><div>
</div></div><div><div><div>25</div></div><div><span>sudo</span><span> </span><span>setfacl</span><span> </span><span>-R</span><span> </span><span>-d</span><span> </span><span>-m</span><span> </span><span>u:"</span><span>$USERNAME</span><span>":rwx</span><span> </span><span>"</span><span>$TARGET_DIR</span><span>"</span></div></div><div><div><div>26</div></div><div>
</div></div><div><div><div>27</div></div><div><span># 验证</span></div></div><div><div><div>28</div></div><div><span>echo</span><span> </span><span>""</span></div></div><div><div><div>29</div></div><div><span>echo</span><span> </span><span>"=== ACL 权限 ==="</span></div></div><div><div><div>30</div></div><div><span>getfacl</span><span> </span><span>"</span><span>$TARGET_DIR</span><span>"</span><span> | </span><span>grep</span><span> </span><span>-E</span><span> </span><span>"(user:|default:)"</span></div></div><div><div><div>31</div></div><div>
</div></div><div><div><div>32</div></div><div><span>echo</span><span> </span><span>""</span></div></div><div><div><div>33</div></div><div><span>echo</span><span> </span><span>"✅ 完成！"</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>13. 命令速查表<a href="#13-命令速查表"><span>#</span></a></h2>

<table><thead><tr><th>操作</th><th>命令</th></tr></thead><tbody><tr><td>给用户授权</td><td><code>setfacl -m u:用户名:rwx 路径</code></td></tr><tr><td>递归授权</td><td><code>setfacl -R -m u:用户名:rwx 路径</code></td></tr><tr><td>默认继承</td><td><code>setfacl -d -m u:用户名:rwx 路径</code></td></tr><tr><td>查看权限</td><td><code>getfacl 路径</code></td></tr><tr><td>删除单个用户权限</td><td><code>setfacl -x u:用户名 路径</code></td></tr><tr><td><strong>删除所有 ACL（恢复默认）</strong></td><td><strong><code>setfacl -b 路径</code></strong></td></tr><tr><td>递归删除所有 ACL</td><td><code>setfacl -R -b 路径</code></td></tr><tr><td>删除默认 ACL</td><td><code>setfacl -k 路径</code></td></tr></tbody></table><hr /><blockquote><p><strong>文档版本：</strong> 2026-08-12
<strong>适用系统：</strong> Debian 12 / Ubuntu 20.04+ / CentOS 7+
<strong>适用平台：</strong> 云服务器 / 本地虚拟机</p></blockquote></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/git-github-complete-guide/</id>
      <title type="text">Git 提交 GitHub 完整实战指南</title>
      <published>2026-08-08T00:00:00.000Z</published>
      <updated>2026-08-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/git-github-complete-guide/"/>
      <summary type="text">从 Fork 仓库到提交 Pull Request 的完整 Git 实战指南，涵盖基础配置、分支管理、上游同步、冲突解决等核心操作。</summary>
      <content type="html"><![CDATA[<blockquote><p>本文档面向希望参与开源项目贡献的开发者，涵盖从 Fork 仓库到提交 Pull Request 的完整 Git 操作流程。
<strong>适用系统：</strong> Windows / macOS / Linux
<strong>适用平台：</strong> 本地开发环境 / 云服务器</p></blockquote>
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%9F%BA%E7%A1%80%E9%85%8D%E7%BD%AE">基础配置</a></li>
<li><a href="#2-fork-%E4%BB%93%E5%BA%93%E4%B8%8E%E5%85%8B%E9%9A%86">Fork 仓库与克隆</a></li>
<li><a href="#3-%E5%B7%B2-fork-%E4%BD%86%E6%9C%AA-git-init-%E7%9A%84%E6%8F%90%E4%BA%A4%E6%B5%81%E7%A8%8B">已 Fork 但未 git init 的提交流程</a></li>
<li><a href="#4-%E5%88%86%E6%94%AF%E6%93%8D%E4%BD%9C">分支操作</a></li>
<li><a href="#5-%E4%B8%8A%E6%B8%B8%E7%AE%A1%E7%90%86">上游管理</a></li>
<li><a href="#6-%E6%97%A5%E5%B8%B8%E5%BC%80%E5%8F%91%E6%8F%90%E4%BA%A4%E6%B5%81%E7%A8%8B">日常开发提交流程</a></li>
<li><a href="#7-pull-request-%E6%8F%90%E4%BA%A4%E6%8C%87%E5%8D%97">Pull Request 提交指南</a></li>
<li><a href="#8-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E4%B8%8E%E8%A7%A3%E5%86%B3">常见问题与解决</a></li>
<li><a href="#9-%E5%B8%B8%E7%94%A8%E5%91%BD%E4%BB%A4%E9%80%9F%E6%9F%A5%E8%A1%A8">常用命令速查表</a></li>
</ol><hr /></section>
<section><h2>1. 基础配置<a href="#1-基础配置"><span>#</span></a></h2><p>首次使用 Git 前，必须配置用户名和邮箱，这些信息会嵌入到每一次提交记录中。</p><section><h3>1.1 配置用户名和邮箱（全局）<a href="#11-配置用户名和邮箱全局"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--global</span><span> </span><span>user.name</span><span> </span><span>"你的GitHub用户名"</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--global</span><span> </span><span>user.email</span><span> </span><span>"你的GitHub注册邮箱"</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>1.2 配置默认编辑器（可选）<a href="#12-配置默认编辑器可选"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--global</span><span> </span><span>core.editor</span><span> </span><span>"vim"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>提示</div></div><div><p>也可设置为 <code>nano</code>、<code>code</code>（VS Code）等你习惯的编辑器。</p></div></div></section><section><h3>1.3 查看当前配置<a href="#13-查看当前配置"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--list</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>user.name</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>user.email</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>2. Fork 仓库与克隆<a href="#2-fork-仓库与克隆"><span>#</span></a></h2><section><h3>2.1 在 GitHub 网页上 Fork 仓库<a href="#21-在-github-网页上-fork-仓库"><span>#</span></a></h3><ol>
<li>打开目标仓库页面</li>
<li>点击右上角 <strong>Fork</strong> 按钮</li>
<li>选择自己的账号，等待 Fork 完成</li>
<li>此时你的账号下会生成一个同名仓库</li>
</ol></section><section><h3>2.2 克隆自己 Fork 的仓库到本地<a href="#22-克隆自己-fork-的仓库到本地"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 使用 HTTPS（无需配置密钥，浏览器登录即可）</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>clone</span><span> </span><span>https://github.com/你的用户名/仓库名.git</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>重要</div></div><div><p>首次克隆时若提示确认主机指纹，输入 <code>yes</code> 回车即可。</p></div></div></section><section><h3>2.3 进入项目目录<a href="#23-进入项目目录"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>cd</span><span> </span><span>仓库名</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>3. 已 Fork 但未 git init 的提交流程<a href="#3-已-fork-但未-git-init-的提交流程"><span>#</span></a></h2><div><div><div></div><div>提示</div></div><div><p><strong>适用场景：</strong> 已在 GitHub Fork 了仓库，在本地修改了代码，但项目目录还没有执行过 <code>git init</code>。</p></div></div><p>以下以 Firefly 主题为例：</p>

<table><thead><tr><th>仓库类型</th><th>地址</th></tr></thead><tbody><tr><td>你的 Fork</td><td><code>https://github.com/wuziyue840/Firefly</code></td></tr><tr><td>作者原仓库</td><td><code>https://github.com/CuteLeaf/Firefly</code></td></tr></tbody></table><section><h3>3.1 进入项目目录并初始化 Git<a href="#31-进入项目目录并初始化-git"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>cd</span><span> </span><span>/path/to/你的项目文件夹</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>init</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>3.2 关联远程仓库（全部使用 HTTPS）<a href="#32-关联远程仓库全部使用-https"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 添加你自己的 Fork 仓库（origin）</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>add</span><span> </span><span>origin</span><span> </span><span>https://github.com/wuziyue840/Firefly.git</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 添加作者原仓库（upstream）</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>add</span><span> </span><span>upstream</span><span> </span><span>https://github.com/CuteLeaf/Firefly.git</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 确认配置</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>-v</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>3.3 先把本地修改提交（关键步骤）<a href="#33-先把本地修改提交关键步骤"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>.</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>-m</span><span> </span><span>"save: 本地修改备份"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p>如果不先 commit，后续 merge 会报错：
<code>error: Untracked working tree file '.gitattributes' would be overwritten by merge.</code></p></div></div></section><section><h3>3.4 拉取作者仓库代码并合并<a href="#34-拉取作者仓库代码并合并"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 获取作者仓库的所有分支信息</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>fetch</span><span> </span><span>upstream</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看作者仓库有哪些分支</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-r</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>重要</div></div><div><p>Firefly 默认分支是 <code>master</code>，不是 <code>main</code>，merge 时请注意分支名。</p></div></div><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 合并作者仓库代码到本地</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>merge</span><span> </span><span>upstream/master</span><span> </span><span>--allow-unrelated-histories</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>提示</div></div><div><p><code>--allow-unrelated-histories</code> 必须添加，因为本地是新仓库，和远程没有共同的历史记录。</p></div></div></section><section><h3>3.5 处理合并冲突<a href="#35-处理合并冲突"><span>#</span></a></h3><p>如果提示冲突，文件里会出现类似标记：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD</span></div></div><div><div><div>2</div></div><div><span>你本地改好的代码</span></div></div><div><div><div>3</div></div><div><span>=======</span></div></div><div><div><div>4</div></div><div><span>作者仓库的代码</span></div></div><div><div><div>5</div></div><div><span>&gt;&gt;&gt;&gt;&gt;&gt;&gt; upstream/master</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>快速解决（全部保留自己的版本）：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--ours</span><span> </span><span>.</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>.</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>-m</span><span> </span><span>"feat: 添加项目功能"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p>merge 状态下不能使用 <code>git commit --amend</code>！会报错：
<code>fatal: You are in the middle of a merge -- cannot amend.</code></p></div></div><p><strong>如需单独处理某个文件：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 保留作者版本</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--theirs</span><span> </span><span>文件名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 保留自己版本</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--ours</span><span> </span><span>文件名</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>3.6 推送到你的 Fork 仓库<a href="#36-推送到你的-fork-仓库"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 首次推送</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>-u</span><span> </span><span>origin</span><span> </span><span>master</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>如果之前用了 SSH，需要改成 HTTPS：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 方法一（推荐）</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>remove</span><span> </span><span>origin</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>add</span><span> </span><span>origin</span><span> </span><span>https://github.com/wuziyue840/Firefly.git</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span># 方法二</span></div></div><div><div><div>7</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>set-url</span><span> </span><span>origin</span><span> </span><span>https://github.com/wuziyue840/Firefly.git</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>-u</span><span> </span><span>origin</span><span> </span><span>master</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>4. 分支操作<a href="#4-分支操作"><span>#</span></a></h2><section><h3>4.1 查看分支<a href="#41-查看分支"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看本地所有分支，当前分支前有 * 号</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>branch</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看远程所有分支</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-r</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 查看本地和远程所有分支</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-a</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>4.2 创建分支<a href="#42-创建分支"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 创建新分支（不切换）</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>新分支名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 创建并立即切换到新分支（最常用）</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-b</span><span> </span><span>新分支名</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># Git 2.23+ 版本推荐语法</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>switch</span><span> </span><span>-c</span><span> </span><span>新分支名</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 基于远程分支创建本地分支</span></div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-b</span><span> </span><span>新分支名</span><span> </span><span>origin/远程分支名</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>4.3 切换分支<a href="#43-切换分支"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 切换到已有分支</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>分支名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># Git 2.23+ 版本推荐语法</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>switch</span><span> </span><span>分支名</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 切换到上一个分支</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>4.4 重命名分支<a href="#44-重命名分支"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 重命名当前分支</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-m</span><span> </span><span>新分支名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 重命名指定分支</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-m</span><span> </span><span>旧分支名</span><span> </span><span>新分支名</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>4.5 删除分支<a href="#45-删除分支"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 删除已合并的本地分支</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-d</span><span> </span><span>分支名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 强制删除本地分支（无论是否合并）</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-D</span><span> </span><span>分支名</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 删除远程分支</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>--delete</span><span> </span><span>分支名</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 或简写</span></div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>:分支名</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>5. 上游管理<a href="#5-上游管理"><span>#</span></a></h2><section><h3>5.1 添加上游仓库（原仓库）<a href="#51-添加上游仓库原仓库"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看当前远程仓库</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>-v</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 添加原仓库为 upstream</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>add</span><span> </span><span>upstream</span><span> </span><span>https://github.com/CuteLeaf/Firefly.git</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 再次查看确认</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>-v</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>确认输出中应同时显示 <code>origin</code> 和 <code>upstream</code> 两个远程地址。</p></section><section><h3>5.2 从上游仓库同步最新代码<a href="#52-从上游仓库同步最新代码"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 拉取上游仓库的最新代码（不合并）</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>fetch</span><span> </span><span>upstream</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 切换到主分支（Firefly 是 master）</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>master</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 将上游主分支合并到本地主分支</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>merge</span><span> </span><span>upstream/master</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 或选择 rebase 方式</span></div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>rebase</span><span> </span><span>upstream/master</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 将更新推送到自己的 Fork</span></div></div><div><div><div>14</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>master</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>5.3 删除上游仓库<a href="#53-删除上游仓库"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>remove</span><span> </span><span>upstream</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>5.4 修改远程仓库地址<a href="#54-修改远程仓库地址"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 修改 origin 地址</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>set-url</span><span> </span><span>origin</span><span> </span><span>https://github.com/wuziyue840/Firefly.git</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 修改 upstream 地址</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>set-url</span><span> </span><span>upstream</span><span> </span><span>https://github.com/CuteLeaf/Firefly.git</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>6. 日常开发提交流程<a href="#6-日常开发提交流程"><span>#</span></a></h2><section><h3>6.1 开始新功能/修复前<a href="#61-开始新功能修复前"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. 确保本地主分支是最新的</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>master</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>git</span><span> </span><span>fetch</span><span> </span><span>upstream</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span>git</span><span> </span><span>merge</span><span> </span><span>upstream/master</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>master</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 2. 基于最新主分支创建功能分支</span></div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-b</span><span> </span><span>feature/功能描述</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 或修复分支</span></div></div><div><div><div>14</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-b</span><span> </span><span>fix/bug描述</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.2 开发过程中<a href="#62-开发过程中"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看文件修改状态</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>status</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看具体修改内容</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>diff</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 添加文件到暂存区</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>文件名</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 或添加所有修改</span></div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>.</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 提交更改</span></div></div><div><div><div>14</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>-m</span><span> </span><span>"feat: 做了什么修改"</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 多次提交后查看提交历史</span></div></div><div><div><div>17</div></div><div><span>git</span><span> </span><span>log</span><span> </span><span>--oneline</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>6.3 提交到远程仓库（自己的 Fork）<a href="#63-提交到远程仓库自己的-fork"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 首次推送新分支到远程（建立追踪关系）</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>-u</span><span> </span><span>origin</span><span> </span><span>分支名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 后续推送（已建立追踪后）</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>push</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 强制推送（慎用！会覆盖远程历史）</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>--force</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 或简写</span></div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>-f</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p><code>--force</code> 会重写远程历史，团队协作分支上<strong>绝对不要</strong>使用，仅限个人 feature 分支且确认无他人基于该分支开发时方可使用。</p></div></div></section><section><h3>6.4 修改最后一次提交<a href="#64-修改最后一次提交"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 修改提交信息</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>--amend</span><span> </span><span>-m</span><span> </span><span>"新的提交说明"</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 添加漏掉的文件到上一次提交</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>漏掉的文件</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>--amend</span><span> </span><span>--no-edit</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>重要</div></div><div><p>如果已经 push 到远程，amend 后需要强制推送：
<code>git push --force-with-lease</code></p></div></div><hr /></section></section>
<section><h2>7. Pull Request 提交指南<a href="#7-pull-request-提交指南"><span>#</span></a></h2><section><h3>7.1 为什么仓库主人能看到你的修改？<a href="#71-为什么仓库主人能看到你的修改"><span>#</span></a></h3><p>因为你 Fork 了仓库，你的 Fork 和原仓库之间建立了关联。当你在 GitHub 上发起 Pull Request 时，GitHub 会自动检测到你 Fork 中的新分支与原仓库之间的差异，并通知仓库主人。</p></section><section><h3>7.2 发起 Pull Request 的完整步骤<a href="#72-发起-pull-request-的完整步骤"><span>#</span></a></h3><section><h4>步骤 1：确保代码质量<a href="#步骤-1确保代码质量"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>status</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>log</span><span> </span><span>--oneline</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h4>步骤 2：推送到自己的 Fork<a href="#步骤-2推送到自己的-fork"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>feature/你的分支名</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h4>步骤 3：在 GitHub 网页上操作<a href="#步骤-3在-github-网页上操作"><span>#</span></a></h4><ol>
<li>打开你 Fork 的仓库页面：<code>https://github.com/wuziyue840/Firefly</code></li>
<li>页面顶部会出现黄色提示条：
<blockquote><p>“This branch is X commits ahead of CuteLeaf/Firefly”
点击 <strong>Contribute</strong> → <strong>Open pull request</strong></p></blockquote>
</li>
<li>如果没有自动提示：
<ul>
<li>点击 <strong>Pull requests</strong> 标签</li>
<li>点击 <strong>New pull request</strong></li>
<li>确认对比设置：
<ul>
<li>base repository: <code>CuteLeaf/Firefly</code></li>
<li>base: <code>master</code></li>
<li>head repository: <code>wuziyue840/Firefly</code></li>
<li>compare: <code>master</code></li>
</ul>
</li>
</ul>
</li>
<li>填写 PR 信息：
<ul>
<li><strong>Title</strong>：简洁描述修改，例如 <code>feat: 添加项目功能</code></li>
<li><strong>Description</strong>：详细说明修改原因、做了什么、如何测试</li>
</ul>
</li>
<li>页面底部选择：
<ul>
<li> <strong>Allow edits by maintainers</strong>（允许作者修改你的 PR，建议勾选）</li>
<li>点击 <strong>Create pull request</strong>（正式提交）</li>
<li>不要点 <strong>Create draft pull request</strong>（草稿模式，不能合并）</li>
</ul>
</li>
</ol></section><section><h4>步骤 4：等待仓库主人审核<a href="#步骤-4等待仓库主人审核"><span>#</span></a></h4><ul>
<li>仓库主人会收到通知邮件和 GitHub 通知</li>
<li>可能会提出修改意见（Review）</li>
<li>根据意见修改后，继续推送到同一分支，PR 会自动更新</li>
</ul></section></section><section><h3>7.3 PR 描述模板示例<a href="#73-pr-描述模板示例"><span>#</span></a></h3><div><div><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>feat: 添加项目功能</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>## Type of change</span></div></div><div><div><div>4</div></div><div><span><span>-</span><span> </span></span><span>[</span><span>x</span><span>]</span><span> New feature (a non-breaking change that adds functionality)</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span>## Checklist</span></div></div><div><div><div>7</div></div><div><span><span>-</span><span> </span></span><span>[</span><span>x</span><span>]</span><span> I have read the CONTRIBUTING document.</span></div></div><div><div><div>8</div></div><div><span><span>-</span><span> </span></span><span>[</span><span>x</span><span>]</span><span> I have checked to ensure that this Pull Request is not for personal changes.</span></div></div><div><div><div>9</div></div><div><span><span>-</span><span> </span></span><span>[</span><span>x</span><span>]</span><span> I have performed a self-review of my own code.</span></div></div><div><div><div>10</div></div><div><span><span>-</span><span> </span></span><span>[</span><span>x</span><span>]</span><span> My changes generate no new warnings.</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span>## Related Issue</span></div></div><div><div><div>13</div></div><div><span>无</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span>## Changes</span></div></div><div><div><div>16</div></div><div><span><span>-</span><span> 添加了项目功能</span></span></div></div><div><div><div>17</div></div><div><span><span>-</span><span> 更新了相关配置文件</span></span></div></div><div><div><div>18</div></div><div>
</div></div><div><div><div>19</div></div><div><span>## How To Test</span></div></div><div><div><div>20</div></div><div><span><span>1.</span><span> 拉取本分支代码</span></span></div></div><div><div><div>21</div></div><div><span><span>2.</span><span> 运行项目查看功能是否正常</span></span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>7.4 PR 被合并后的清理工作<a href="#74-pr-被合并后的清理工作"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 切换回主分支</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>master</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 同步上游最新代码</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>fetch</span><span> </span><span>upstream</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>git</span><span> </span><span>merge</span><span> </span><span>upstream/master</span></div></div><div><div><div>8</div></div><div>
</div></div><div><div><div>9</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>master</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span># 删除本地功能分支</span></div></div><div><div><div>12</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-d</span><span> </span><span>feature/你的分支名</span></div></div><div><div><div>13</div></div><div>
</div></div><div><div><div>14</div></div><div><span># 删除远程功能分支</span></div></div><div><div><div>15</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>--delete</span><span> </span><span>feature/你的分支名</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section></section>
<section><h2>8. 常见问题与解决<a href="#8-常见问题与解决"><span>#</span></a></h2><section><h3>8.1 merge 时报错 “not something we can merge”<a href="#81-merge-时报错-not-something-we-can-merge"><span>#</span></a></h3>

<table><thead><tr><th>原因</th><th>解决</th></tr></thead><tbody><tr><td>分支名不对，作者仓库默认分支可能是 <code>master</code> 不是 <code>main</code></td><td><code>git merge upstream/master --allow-unrelated-histories</code></td></tr></tbody></table></section><section><h3>8.2 merge 时报错 “Untracked working tree file would be overwritten”<a href="#82-merge-时报错-untracked-working-tree-file-would-be-overwritten"><span>#</span></a></h3>

<table><thead><tr><th>原因</th><th>解决</th></tr></thead><tbody><tr><td>本地有未提交的文件，Git 不敢覆盖</td><td>先 <code>git add . &amp;&amp; git commit -m "save: 备份"</code>，再 merge</td></tr></tbody></table></section><section><h3>8.3 merge 后 commit 报错 “unmerged files”<a href="#83-merge-后-commit-报错-unmerged-files"><span>#</span></a></h3>

<table><thead><tr><th>原因</th><th>解决</th></tr></thead><tbody><tr><td>冲突文件还没标记为已解决</td><td><code>git checkout --ours . &amp;&amp; git add . &amp;&amp; git commit -m "feat: xxx"</code></td></tr></tbody></table></section><section><h3>8.4 merge 状态下不能 amend<a href="#84-merge-状态下不能-amend"><span>#</span></a></h3>

<table><thead><tr><th>报错</th><th>解决</th></tr></thead><tbody><tr><td><code>fatal: You are in the middle of a merge -- cannot amend.</code></td><td>merge 状态下直接用 <code>git commit -m "xxx"</code>，不要加 <code>--amend</code></td></tr></tbody></table></section><section><h3>8.5 push 时提示输入用户名密码<a href="#85-push-时提示输入用户名密码"><span>#</span></a></h3>

<table><thead><tr><th>原因</th><th>解决</th></tr></thead><tbody><tr><td>HTTPS 方式需要 GitHub 登录验证</td><td>输入你的 GitHub 用户名和 <strong>Personal Access Token</strong>（不是密码）</td></tr></tbody></table><div><div><div></div><div>提示</div></div><div><p>如果没有 Token，去 GitHub <strong>Settings</strong> → <strong>Developer settings</strong> → <strong>Personal access tokens</strong> → <strong>Tokens (classic)</strong> → <strong>Generate new token</strong>。</p></div></div></section><section><h3>8.6 首次连接 GitHub 提示确认指纹<a href="#86-首次连接-github-提示确认指纹"><span>#</span></a></h3>

<table><thead><tr><th>提示</th><th>解决</th></tr></thead><tbody><tr><td><code>Are you sure you want to continue connecting (yes/no)?</code></td><td>输入 <code>yes</code> 回车即可</td></tr></tbody></table></section><section><h3>8.7 push 时提示 “rejected: non-fast-forward”<a href="#87-push-时提示-rejected-non-fast-forward"><span>#</span></a></h3>

<table><thead><tr><th>原因</th><th>解决</th></tr></thead><tbody><tr><td>远程分支有更新，本地不是最新</td><td><code>git pull origin 分支名</code>，解决冲突后再次 push</td></tr></tbody></table></section><section><h3>8.8 合并冲突（Merge Conflict）手动解决<a href="#88-合并冲突merge-conflict手动解决"><span>#</span></a></h3><p>文件中出现冲突标记：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>&lt;&lt;&lt;&lt;&lt;&lt;&lt; HEAD</span></div></div><div><div><div>2</div></div><div><span>你的代码</span></div></div><div><div><div>3</div></div><div><span>=======</span></div></div><div><div><div>4</div></div><div><span>别人的代码</span></div></div><div><div><div>5</div></div><div><span>&gt;&gt;&gt;&gt;&gt;&gt;&gt; branch-name</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>手动编辑文件，保留需要的代码，删除标记行后：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>冲突文件</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>-m</span><span> </span><span>"解决合并冲突"</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>8.9 误删了本地分支<a href="#89-误删了本地分支"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>reflog</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-b</span><span> </span><span>分支名</span><span> </span><span>commit-hash</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>8.10 误操作后想回退<a href="#810-误操作后想回退"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看操作历史</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>reflog</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 撤销提交但保留修改</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>reset</span><span> </span><span>--soft</span><span> </span><span>HEAD~1</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 撤销提交并丢弃修改（慎用）</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>reset</span><span> </span><span>--hard</span><span> </span><span>HEAD~1</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>警告</div></div><div><p><code>git reset --hard</code> 会永久丢弃未提交的修改，执行前请确认。</p></div></div></section><section><h3>8.11 忽略文件不生效<a href="#811-忽略文件不生效"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>rm</span><span> </span><span>-r</span><span> </span><span>--cached</span><span> </span><span>.</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>.</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>-m</span><span> </span><span>"更新 .gitignore"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>9. 常用命令速查表<a href="#9-常用命令速查表"><span>#</span></a></h2><section><h3>配置<a href="#配置"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--global</span><span> </span><span>user.name</span><span> </span><span>"name"</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--global</span><span> </span><span>user.email</span><span> </span><span>"email"</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>config</span><span> </span><span>--list</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>仓库操作<a href="#仓库操作"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>clone</span><span> </span><span>https://github.com/用户名/仓库名.git</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>-v</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>add</span><span> </span><span>origin</span><span> </span><span>https://github.com/用户名/仓库名.git</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>add</span><span> </span><span>upstream</span><span> </span><span>https://github.com/作者/仓库名.git</span></div></div><div><div><div>8</div></div><div>
</div></div><div><div><div>9</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>set-url</span><span> </span><span>origin</span><span> </span><span>https://github.com/用户名/仓库名.git</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span>git</span><span> </span><span>remote</span><span> </span><span>remove</span><span> </span><span>upstream</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span>git</span><span> </span><span>fetch</span><span> </span><span>upstream</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span>git</span><span> </span><span>merge</span><span> </span><span>upstream/master</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>分支操作<a href="#分支操作"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>branch</span><span>                    </span><span># 查看本地分支</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-a</span><span>                 </span><span># 查看所有分支</span></div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>分支名</span><span>             </span><span># 创建分支</span></div></div><div><div><div>4</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>-b</span><span> </span><span>分支名</span><span>        </span><span># 创建并切换</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>switch</span><span> </span><span>-c</span><span> </span><span>分支名</span><span>          </span><span># 创建并切换（新语法）</span></div></div><div><div><div>6</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>分支名</span><span>           </span><span># 切换分支</span></div></div><div><div><div>7</div></div><div><span>git</span><span> </span><span>switch</span><span> </span><span>分支名</span><span>             </span><span># 切换分支（新语法）</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-d</span><span> </span><span>分支名</span><span>          </span><span># 删除已合并分支</span></div></div><div><div><div>9</div></div><div><span>git</span><span> </span><span>branch</span><span> </span><span>-D</span><span> </span><span>分支名</span><span>          </span><span># 强制删除分支</span></div></div><div><div><div>10</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>--delete</span><span> </span><span>分支名</span><span>  </span><span># 删除远程分支</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>提交操作<a href="#提交操作"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>status</span><span>                    </span><span># 查看状态</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>diff</span><span>                      </span><span># 查看差异</span></div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>文件</span><span>                  </span><span># 添加文件</span></div></div><div><div><div>4</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>.</span><span>                     </span><span># 添加所有</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>-m</span><span> </span><span>"说明"</span><span>          </span><span># 提交</span></div></div><div><div><div>6</div></div><div><span>git</span><span> </span><span>commit</span><span> </span><span>--amend</span><span> </span><span>-m</span><span> </span><span>"说明"</span><span>  </span><span># 修改最后一次提交</span></div></div><div><div><div>7</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>origin</span><span> </span><span>分支名</span><span>        </span><span># 推送到远程</span></div></div><div><div><div>8</div></div><div><span>git</span><span> </span><span>push</span><span> </span><span>-u</span><span> </span><span>origin</span><span> </span><span>分支名</span><span>     </span><span># 首次推送并建立追踪</span></div></div><div><div><div>9</div></div><div><span>git</span><span> </span><span>log</span><span> </span><span>--oneline</span><span>             </span><span># 查看提交历史</span></div></div><div><div><div>10</div></div><div><span>git</span><span> </span><span>log</span><span> </span><span>--graph</span><span> </span><span>--oneline</span><span>     </span><span># 图形化查看历史</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>冲突解决<a href="#冲突解决"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--ours</span><span> </span><span>.</span><span>         </span><span># 全部保留自己版本</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--theirs</span><span> </span><span>文件</span><span>    </span><span># 单个文件保留作者版本</span></div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--ours</span><span> </span><span>文件</span><span>      </span><span># 单个文件保留自己版本</span></div></div><div><div><div>4</div></div><div><span>git</span><span> </span><span>add</span><span> </span><span>.</span><span>                     </span><span># 标记冲突已解决</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>撤销操作<a href="#撤销操作"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>checkout</span><span> </span><span>--</span><span> </span><span>文件</span><span>          </span><span># 撤销文件修改</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>reset</span><span> </span><span>HEAD</span><span> </span><span>文件</span><span>           </span><span># 取消暂存</span></div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>reset</span><span> </span><span>--soft</span><span> </span><span>HEAD~1</span><span>       </span><span># 撤销提交保留修改</span></div></div><div><div><div>4</div></div><div><span>git</span><span> </span><span>reset</span><span> </span><span>--hard</span><span> </span><span>HEAD~1</span><span>       </span><span># 撤销提交丢弃修改</span></div></div><div><div><div>5</div></div><div><span>git</span><span> </span><span>reflog</span><span>                    </span><span># 查看操作历史</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>同步操作<a href="#同步操作"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>git</span><span> </span><span>pull</span><span>                      </span><span># 拉取并合并</span></div></div><div><div><div>2</div></div><div><span>git</span><span> </span><span>pull</span><span> </span><span>--rebase</span><span>             </span><span># 拉取并使用 rebase</span></div></div><div><div><div>3</div></div><div><span>git</span><span> </span><span>rebase</span><span> </span><span>master</span><span>             </span><span># 将当前分支变基到 master</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section><section><h3>附录：Fork 工作流图解<a href="#附录fork-工作流图解"><span>#</span></a></h3><div><div><div><div><span><p>你通过 PR 贡献代码</p></span></div><div><span><p>git push origin feature/xx</p></span></div><div><span><p>git merge upstream/master</p></span></div><div><span><p>git pull origin master</p></span></div><div><span><p>原仓库 Upstream</p></span></div><div><span><p>你的 Fork Origin</p></span></div><div><span><p>本地仓库 Local</p></span></div>
</div><div><div><span><p>你通过 PR 贡献代码</p></span></div><div><span><p>git push origin feature/xx</p></span></div><div><span><p>git merge upstream/master</p></span></div><div><span><p>git pull origin master</p></span></div><div><span><p>原仓库 Upstream</p></span></div><div><span><p>你的 Fork Origin</p></span></div><div><span><p>本地仓库 Local</p></span></div>
</div></div></div><hr /><blockquote><p><strong>文档版本：</strong> 2026-08-09
<strong>适用系统：</strong> Windows / macOS / Linux
<strong>适用平台：</strong> 本地开发环境 / 云服务器</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/git.jpg">点击下载 JPG 版本</a>
<br />
<a href="/downloads/Git提交GitHub完整指南.txt">点击下载 TXT 版本</a></p></div></div><hr /></section></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/1panel-install-debian12/</id>
      <title type="text">1Panel 安装教程（Debian 12）</title>
      <published>2026-07-30T00:00:00.000Z</published>
      <updated>2026-11-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/1panel-install-debian12/"/>
      <summary type="text">Debian 12 下 1Panel 面板的完整安装教程，涵盖 Docker 官方源/第三方安装、镜像加速配置、防火墙放行、IP 白名单及安全加固。</summary>
      <content type="html"><![CDATA[<blockquote><p>本文档面向在 <strong>Debian 12</strong> 上部署 1Panel 面板的用户，步骤精简，命令可直接复制执行。
<strong>适用系统：</strong> Debian 12 (Bookworm)<br />
<strong>适用平台：</strong> 云服务器 / 本地虚拟机</p></blockquote>
<hr />
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%AE%89%E8%A3%85-docker">安装 Docker</a></li>
<li><a href="#2-%E9%85%8D%E7%BD%AE%E9%95%9C%E5%83%8F%E5%8A%A0%E9%80%9F">配置镜像加速</a></li>
<li><a href="#3-%E5%AE%89%E8%A3%85-1panel">安装 1Panel</a></li>
<li><a href="#4-%E6%94%BE%E8%A1%8C%E7%AB%AF%E5%8F%A3">放行端口</a></li>
<li><a href="#5-%E7%99%BB%E5%BD%95%E9%9D%A2%E6%9D%BF">登录面板</a></li>
<li><a href="#6-ip-%E7%99%BD%E5%90%8D%E5%8D%95">IP 白名单</a></li>
<li><a href="#7-%E6%8A%8A%E8%87%AA%E5%B7%B1%E9%94%81%E5%A4%96%E9%9D%A2%E4%BA%86">把自己锁外面了</a></li>
<li><a href="#8-%E5%B8%B8%E7%94%A8%E5%91%BD%E4%BB%A4">常用命令</a></li>
<li><a href="#9-%E5%AE%89%E5%85%A8%E5%BB%BA%E8%AE%AE">安全建议</a></li>
</ol><hr /></section>
<section><h2>1. 安装 Docker(可以不安装，下面的1panel安装脚本自带一键安装)<a href="#1-安装-docker可以不安装下面的1panel安装脚本自带一键安装"><span>#</span></a></h2><p>Debian 12 官方源里的 <code>docker.io</code> 版本足够新，直接 <code>apt</code> 安装最省事。如果你需要最新版，也可以用第三方源。</p><section><h3>1.1 方式一：apt 官方源（推荐，最简单）<a href="#11-方式一apt-官方源推荐最简单"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>docker.io</span><span> </span><span>docker-compose</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>start</span><span> </span><span>docker</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>enable</span><span> </span><span>docker</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>验证安装：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>docker</span><span> </span><span>-v</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>TIP</div></div><div><p>如果你之前装过其他版本的 Docker，建议先卸载干净再执行上面命令，避免冲突。</p></div></div></section><section><h3>1.2 方式二：Docker 官方源（版本最新）<a href="#12-方式二docker-官方源版本最新"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. 卸载旧版本</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>remove</span><span> </span><span>-y</span><span> </span><span>docker</span><span> </span><span>docker-engine</span><span> </span><span>docker.io</span><span> </span><span>containerd</span><span> </span><span>runc</span><span> 2&gt;</span><span>/dev/null</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 2. 安装依赖</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>ca-certificates</span><span> </span><span>curl</span><span> </span><span>gnupg</span></div></div><div><div><div>8</div></div><div>
</div></div><div><div><div>9</div></div><div><span># 3. 添加 Docker 官方 GPG 密钥</span></div></div><div><div><div>10</div></div><div><span>sudo</span><span> </span><span>install</span><span> </span><span>-m</span><span> </span><span>0755</span><span> </span><span>-d</span><span> </span><span>/etc/apt/keyrings</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span>curl</span><span> </span><span>-fsSL</span><span> </span><span>https://download.docker.com/linux/debian/gpg</span><span> | </span><span>sudo</span><span> </span><span>gpg</span><span> </span><span>--dearmor</span><span> </span><span>-o</span><span> </span><span>/etc/apt/keyrings/docker.gpg</span></div></div><div><div><div>13</div></div><div>
</div></div><div><div><div>14</div></div><div><span>sudo</span><span> </span><span>chmod</span><span> </span><span>a+r</span><span> </span><span>/etc/apt/keyrings/docker.gpg</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 4. 添加官方 APT 源</span></div></div><div><div><div>17</div></div><div><span>echo</span><span> </span><span>"deb [arch=$(</span><span>dpkg</span><span> </span><span>--print-architecture</span><span>) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(</span><span>lsb_release</span><span> </span><span>-cs</span><span>) stable"</span><span> | </span><span>sudo</span><span> </span><span>tee</span><span> </span><span>/etc/apt/sources.list.d/docker.list</span><span> &gt; </span><span>/dev/null</span></div></div><div><div><div>18</div></div><div>
</div></div><div><div><div>19</div></div><div><span># 5. 安装 Docker</span></div></div><div><div><div>20</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span></div></div><div><div><div>21</div></div><div>
</div></div><div><div><div>22</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>docker-ce</span><span> </span><span>docker-ce-cli</span><span> </span><span>containerd.io</span><span> </span><span>docker-buildx-plugin</span><span> </span><span>docker-compose-plugin</span></div></div><div><div><div>23</div></div><div>
</div></div><div><div><div>24</div></div><div><span># 6. 启动并设置开机自启</span></div></div><div><div><div>25</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>start</span><span> </span><span>docker</span></div></div><div><div><div>26</div></div><div>
</div></div><div><div><div>27</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>enable</span><span> </span><span>docker</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><p>验证安装：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>docker</span><span> </span><span>-v</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>1.3 方式三：一键脚本安装（最快，适合测试环境）<a href="#13-方式三一键脚本安装最快适合测试环境"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>curl</span><span> </span><span>-fsSL</span><span> </span><span>https://get.docker.com</span><span> </span><span>-o</span><span> </span><span>get-docker.sh</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>sh</span><span> </span><span>get-docker.sh</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>start</span><span> </span><span>docker</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>enable</span><span> </span><span>docker</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>WARNING</div></div><div><p>一键脚本会自动检测系统并安装最新稳定版，但<strong>不适合生产环境</strong>，因为来源不可控。生产环境建议用方式一或方式二。</p></div></div><hr /></section></section>
<section><h2>2. 配置镜像加速<a href="#2-配置镜像加速"><span>#</span></a></h2><p>不配置的话拉镜像慢到怀疑人生，国内服务器必做。</p><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>mkdir</span><span> </span><span>-p</span><span> </span><span>/etc/docker</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>tee</span><span> </span><span>/etc/docker/daemon.json</span><span> &lt;&lt;-</span><span>'EOF'</span></div></div><div><div><div>4</div></div><div><span>{</span></div></div><div><div><div>5</div></div><div><span><span>  </span></span><span>"registry-mirrors": [</span></div></div><div><div><div>6</div></div><div><span><span>    </span></span><span>"https://docker.1panel.live",</span></div></div><div><div><div>7</div></div><div><span><span>    </span></span><span>"https://hub.rat.dev",</span></div></div><div><div><div>8</div></div><div><span><span>    </span></span><span>"https://docker.m.daocloud.io"</span></div></div><div><div><div>9</div></div><div><span><span>  </span></span><span>]</span></div></div><div><div><div>10</div></div><div><span>}</span></div></div><div><div><div>11</div></div><div><span>EOF</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>daemon-reload</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>restart</span><span> </span><span>docker</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><div><div><div></div><div>IMPORTANT</div></div><div><p>镜像加速地址可能会失效，如果拉镜像仍然很慢，可以去 <a href="https://github.com/yeasy/docker_practice/blob/master/install/mirror.md" target="_blank">Docker 镜像加速站</a> 找最新的地址替换。</p></div></div><hr /></section>
<section><h2>3. 安装 1Panel（一键安装版）<a href="#3-安装-1panel一键安装版"><span>#</span></a></h2><section><h3>3.1 下载安装脚本<a href="#31-下载安装脚本"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>curl</span><span> </span><span>-sSL</span><span> </span><span>https://resource.fit2cloud.com/1panel/package/quick_start.sh</span><span> </span><span>-o</span><span> </span><span>quick_start.sh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>WARNING</div></div><div><p>如果下载下来的是 HTML 错误页面（之前遇到过），说明官方源被拦截或网络不通，换国际源：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>curl</span><span> </span><span>-sSL</span><span> </span><span>https://resource.1panel.pro/quick_start.sh</span><span> </span><span>-o</span><span> </span><span>quick_start.sh</span><span> &amp;&amp; </span><span>bash</span><span> </span><span>quick_start.sh</span></div></div></code></pre><div><div></div><div></div></div></figure></div></div></div><p>Ubuntu 特有的两个“坑”：缺少 curl 命令</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span><span> &amp;&amp; </span><span>sudo</span><span> </span><span>apt</span><span> </span><span>upgrade</span><span> </span><span>-y</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>-y</span><span> </span><span>curl</span><span> </span><span>wget</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>Ubuntu安装命令同上</p></section><section><h3>3.2 执行安装<a href="#32-执行安装"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>bash</span><span> </span><span>quick_start.sh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>安装向导交互说明：</strong></p>

<table><thead><tr><th>提示项</th><th>建议操作</th></tr></thead><tbody><tr><td>安装目录</td><td>直接回车，默认 <code>/opt</code></td></tr><tr><td>是否安装 Docker</td><td>输入 <code>n</code>（第 1 步已装）</td></tr><tr><td>是否配置镜像加速</td><td>输入 <code>n</code>（第 2 步已配）</td></tr><tr><td>面板端口</td><td>回车或自定义，<strong>建议改掉默认 <code>18061</code></strong></td></tr><tr><td>安全入口</td><td>回车或自定义，<strong>记好这个后缀</strong>，访问必须带</td></tr><tr><td>面板用户名</td><td>回车或自定义</td></tr><tr><td>面板密码</td><td><strong>自己输一个强密码</strong>，12 位以上，大小写+数字+符号</td></tr></tbody></table><p>安装完成后终端会显示：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>外网地址: http://47.xxx.xxx.xxx:18061/xxxxxx</span></div></div><div><div><div>2</div></div><div><span>用户名: xxxxxxxx</span></div></div><div><div><div>3</div></div><div><span>密码: xxxxxxxx</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>CAUTION</div></div><div><p><strong>立刻复制保存！</strong> 丢了只能 SSH 进去用 <code>1pctl</code> 命令重置。</p></div></div><hr /></section></section>
<section><h2>4. 放行端口<a href="#4-放行端口"><span>#</span></a></h2><section><h3>4.1 本地防火墙（ufw）<a href="#41-本地防火墙ufw"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>18061/tcp</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>reload</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>4.2 云服务器安全组<a href="#42-云服务器安全组"><span>#</span></a></h3><p>去云服务商控制台 → 安全组 → 入站规则，添加：</p>

<table><thead><tr><th>协议</th><th>端口</th><th>授权对象</th><th>说明</th></tr></thead><tbody><tr><td>TCP</td><td><code>18061</code></td><td><code>0.0.0.0/0</code></td><td>1Panel 面板访问（先临时放开）</td></tr></tbody></table><div><div><div></div><div>IMPORTANT</div></div><div><p>等后面配好 IP 白名单后，安全组里的 <code>0.0.0.0/0</code> 建议改成你的公网 IP/32，双重保险。</p></div></div><hr /></section></section>
<section><h2>5. 登录面板<a href="#5-登录面板"><span>#</span></a></h2><p>浏览器访问终端输出的外网地址，输入用户名密码即可进入。</p><hr /></section>
<section><h2>6. IP 白名单<a href="#6-ip-白名单"><span>#</span></a></h2><p>只允许你的 IP 访问面板，其他人连页面都看不到。</p><section><h3>6.1 查自己的公网 IP<a href="#61-查自己的公网-ip"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>curl</span><span> </span><span>-s</span><span> </span><span>ip.sb</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.2 在 1Panel 中配置<a href="#62-在-1panel-中配置"><span>#</span></a></h3><p>路径：<strong>1Panel → 主机 → 防火墙 → 创建规则</strong></p><p><strong>规则 1（允许，必须放前面）：</strong></p>

<table><thead><tr><th>配置项</th><th>值</th></tr></thead><tbody><tr><td>策略</td><td>允许</td></tr><tr><td>协议</td><td>TCP</td></tr><tr><td>端口</td><td><code>18061</code></td></tr><tr><td>IP 来源</td><td><code>你的公网IP/32</code>（如 <code>123.45.67.89/32</code>）</td></tr></tbody></table><p><strong>规则 2（拒绝，必须放规则 1 后面）：</strong></p>

<table><thead><tr><th>配置项</th><th>值</th></tr></thead><tbody><tr><td>策略</td><td>拒绝</td></tr><tr><td>协议</td><td>TCP</td></tr><tr><td>端口</td><td><code>18061</code></td></tr><tr><td>IP 来源</td><td><code>0.0.0.0/0</code></td></tr></tbody></table><div><div><div></div><div>WARNING</div></div><div><p>规则是按顺序匹配的，<strong>“允许”必须在”拒绝”前面</strong>！如果顺序反了，你自己也进不去了。</p></div></div><hr /></section></section>
<section><h2>7. 把自己锁外面了<a href="#7-把自己锁外面了"><span>#</span></a></h2><p>如果白名单配错、IP 变了、或者规则顺序搞反导致进不去面板：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># SSH 登录服务器执行</span></div></div><div><div><div>2</div></div><div><span>1pctl</span><span> </span><span>reset</span><span> </span><span>ips</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>这条命令会取消所有 IP 访问限制，恢复允许所有 IP。然后重新登录面板，把白名单改对。</p><hr /></section>
<section><h2>8. 常用命令<a href="#8-常用命令"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看面板登录信息（忘了地址/账号时救命用）</span></div></div><div><div><div>2</div></div><div><span>1pctl</span><span> </span><span>user-info</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 重置密码</span></div></div><div><div><div>5</div></div><div><span>1pctl</span><span> </span><span>reset</span><span> </span><span>password</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 重置安全入口</span></div></div><div><div><div>8</div></div><div><span>1pctl</span><span> </span><span>reset</span><span> </span><span>entrance</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 更新到最新版本</span></div></div><div><div><div>11</div></div><div><span>1pctl</span><span> </span><span>update</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 查看服务状态</span></div></div><div><div><div>14</div></div><div><span>1pctl</span><span> </span><span>status</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>9. 安全建议<a href="#9-安全建议"><span>#</span></a></h2><ol>
<li>
<p><strong>改端口</strong>：别用默认 <code>18061</code>，改成五位数的不常用端口</p>
</li>
<li>
<p><strong>改安全入口</strong>：安装时生成的随机字符串可以留着，但建议记好，或者自定义一个易记的</p>
</li>
<li>
<p><strong>开 HTTPS</strong>：面板设置里可以申请 Let’s Encrypt 证书</p>
</li>
<li>
<p><strong>开两步验证</strong>：面板设置 → 安全 → 绑定 Authenticator</p>
</li>
<li>
<p><strong>定期改密码</strong>：别一个密码用到底</p>
</li>
<li>
<p><strong>定期备份</strong>：1Panel 有定时备份功能，网站和数据库都备上</p>
</li>
<li>
<p><strong>及时更新</strong>：有安全补丁就升</p>
</li>
</ol><hr /><blockquote><p><strong>文档版本：</strong> 2026-07-30<br />
<strong>适用系统：</strong> Debian 12 (Bookworm)<br />
<strong>适用平台：</strong> 云服务器 / 本地虚拟机</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/linux/1Panel安装教程.txt">点击下载 TXT 版本</a></p></div></div><hr /></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/linux-account-switch-guide/</id>
      <title type="text">Linux 账号切换使用手册</title>
      <published>2026-07-30T00:00:00.000Z</published>
      <updated>2026-08-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/linux-account-switch-guide/"/>
      <summary type="text">Linux 用户创建、账号切换、sudo 权限配置及 SSH 多用户登录的完整操作手册。</summary>
      <content type="html"><![CDATA[<blockquote><p>本文档涵盖 Linux 系统中创建用户、切换账号、赋予 sudo 权限及 SSH 多用户登录的常用操作。</p></blockquote>
<hr />
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%88%9B%E5%BB%BA%E6%96%B0%E7%94%A8%E6%88%B7">创建新用户</a></li>
<li><a href="#2-%E5%88%87%E6%8D%A2%E8%B4%A6%E5%8F%B7%E7%9A%84%E5%B8%B8%E7%94%A8%E6%96%B9%E6%B3%95">切换账号的常用方法</a></li>
<li><a href="#3-%E6%9F%A5%E7%9C%8B%E5%BD%93%E5%89%8D%E7%94%A8%E6%88%B7%E4%BF%A1%E6%81%AF">查看当前用户信息</a></li>
<li><a href="#4-%E9%80%80%E5%87%BA%E5%BD%93%E5%89%8D%E7%94%A8%E6%88%B7">退出当前用户</a></li>
<li><a href="#5-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98">常见问题</a></li>
<li><a href="#6-%E5%BF%AB%E9%80%9F%E5%8F%82%E8%80%83%E8%A1%A8">快速参考表</a></li>
</ol><hr /></section>
<section><h2>1. 创建新用户<a href="#1-创建新用户"><span>#</span></a></h2><section><h3>1.1 创建用户并设置密码<a href="#11-创建用户并设置密码"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 创建用户（带家目录，指定 bash shell）</span></div></div><div><div><div>2</div></div><div><span>useradd</span><span> </span><span>-m</span><span> </span><span>-s</span><span> </span><span>/bin/bash</span><span> </span><span>用户名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 设置密码（系统会提示输入两次）</span></div></div><div><div><div>5</div></div><div><span>passwd</span><span> </span><span>用户名</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>示例：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>useradd</span><span> </span><span>-m</span><span> </span><span>-s</span><span> </span><span>/bin/bash</span><span> </span><span>bot</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>passwd</span><span> </span><span>bot</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 输入密码: ********</span></div></div><div><div><div>6</div></div><div><span># 再次输入密码: ********</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>1.2 创建 sudo 权限用户（可选）<a href="#12-创建-sudo-权限用户可选"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 将用户加入 sudo 组</span></div></div><div><div><div>2</div></div><div><span>usermod</span><span> </span><span>-aG</span><span> </span><span>sudo</span><span> </span><span>用户名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 或编辑 sudoers 文件</span></div></div><div><div><div>5</div></div><div><span>visudo</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 添加一行：用户名 ALL=(ALL:ALL) ALL</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>2. 切换账号的常用方法<a href="#2-切换账号的常用方法"><span>#</span></a></h2><section><h3>方法 1：su 命令（Switch User）<a href="#方法-1su-命令switch-user"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 切换到指定用户（需要输入目标用户的密码）</span></div></div><div><div><div>2</div></div><div><span>su</span><span> </span><span>-</span><span> </span><span>用户名</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 示例：切换到 bot 用户</span></div></div><div><div><div>5</div></div><div><span>su</span><span> </span><span>-</span><span> </span><span>bot</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 只切换用户身份，不切换环境变量</span></div></div><div><div><div>8</div></div><div><span>su</span><span> </span><span>用户名</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 切换到 root 用户</span></div></div><div><div><div>11</div></div><div><span>su</span><span> </span><span>-</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 或</span></div></div><div><div><div>14</div></div><div><span>su</span><span> </span><span>-</span><span> </span><span>root</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>参数说明：</strong></p>

<table><thead><tr><th>参数</th><th>说明</th></tr></thead><tbody><tr><td><code>-</code> 或 <code>-l</code></td><td>完全切换，加载目标用户的环境变量（推荐）</td></tr><tr><td>不加 <code>-</code></td><td>半切换，保留当前用户的环境变量</td></tr></tbody></table></section><section><h3>方法 2：sudo 命令（以其他用户身份执行）<a href="#方法-2sudo-命令以其他用户身份执行"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 以 root 身份执行命令</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>命令</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 以指定用户身份执行命令</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>-u</span><span> </span><span>用户名</span><span> </span><span>命令</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 示例：以 bot 用户身份运行脚本</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>-u</span><span> </span><span>bot</span><span> </span><span>/home/bot/script.sh</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 切换到 root 用户的 shell</span></div></div><div><div><div>11</div></div><div><span>sudo</span><span> </span><span>-i</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 切换到指定用户的 shell</span></div></div><div><div><div>14</div></div><div><span>sudo</span><span> </span><span>-u</span><span> </span><span>用户名</span><span> </span><span>-i</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>方法 3：ssh 远程登录（不同用户）<a href="#方法-3ssh-远程登录不同用户"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 以指定用户登录远程服务器</span></div></div><div><div><div>2</div></div><div><span>ssh</span><span> </span><span>用户名@服务器IP</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 示例</span></div></div><div><div><div>5</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>22</span><span> </span><span>bot@192.168.1.100</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 指定端口</span></div></div><div><div><div>8</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>端口号</span><span> </span><span>用户名@服务器IP</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>3. 查看当前用户信息<a href="#3-查看当前用户信息"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看当前登录用户</span></div></div><div><div><div>2</div></div><div><span>whoami</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看当前用户详细信息</span></div></div><div><div><div>5</div></div><div><span>id</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 查看当前登录的所有用户</span></div></div><div><div><div>8</div></div><div><span>who</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 查看用户登录历史</span></div></div><div><div><div>11</div></div><div><span>last</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 查看当前用户的环境变量</span></div></div><div><div><div>14</div></div><div><span>echo</span><span> </span><span>$USER</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span>echo</span><span> </span><span>$HOME</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span>echo</span><span> </span><span>$SHELL</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>4. 退出当前用户<a href="#4-退出当前用户"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 退出当前用户，返回上一个用户</span></div></div><div><div><div>2</div></div><div><span>exit</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 或按快捷键</span></div></div><div><div><div>5</div></div><div><span>Ctrl</span><span> </span><span>+</span><span> </span><span>D</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 注销当前会话</span></div></div><div><div><div>8</div></div><div><span>logout</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>5. 常见问题<a href="#5-常见问题"><span>#</span></a></h2><section><h3>Q1：su 切换时提示 “Authentication failure”<a href="#q1su-切换时提示-authentication-failure"><span>#</span></a></h3><ul>
<li><strong>原因：</strong> 密码错误或用户不存在</li>
<li><strong>解决：</strong> 确认用户名和密码正确，或检查用户是否存在：<code>id 用户名</code></li>
</ul></section><section><h3>Q2：sudo 提示 “用户不在 sudoers 文件中”<a href="#q2sudo-提示-用户不在-sudoers-文件中"><span>#</span></a></h3><ul>
<li><strong>原因：</strong> 当前用户没有 sudo 权限</li>
<li><strong>解决：</strong> 用 root 用户执行 <code>usermod -aG sudo 用户名</code>，然后重新登录</li>
</ul></section><section><h3>Q3：切换后环境变量不对<a href="#q3切换后环境变量不对"><span>#</span></a></h3><ul>
<li><strong>原因：</strong> 使用了 <code>su</code> 而不是 <code>su -</code></li>
<li><strong>解决：</strong> 使用 <code>su - 用户名</code> 进行完全切换</li>
</ul></section><section><h3>Q4：SSH 密码登录失败<a href="#q4ssh-密码登录失败"><span>#</span></a></h3><ul>
<li>检查 SSH 配置：<code>cat /etc/ssh/sshd_config | grep PasswordAuthentication</code></li>
<li>确保值为 <code>yes</code></li>
<li>重启 SSH 服务：<code>sudo systemctl restart ssh</code></li>
</ul><div><div><div></div><div>IMPORTANT</div></div><div><p>Debian/Ubuntu 上 SSH 服务名是 <code>ssh</code>，不是 <code>sshd</code>。<code>systemctl restart sshd</code> 在某些系统上可能不生效，建议使用 <code>systemctl restart ssh</code>。</p></div></div><hr /></section></section>
<section><h2>6. 快速参考表<a href="#6-快速参考表"><span>#</span></a></h2>

<table><thead><tr><th>操作</th><th>命令</th></tr></thead><tbody><tr><td>创建用户</td><td><code>useradd -m -s /bin/bash 用户名</code></td></tr><tr><td>设置密码</td><td><code>passwd 用户名</code></td></tr><tr><td>完全切换到用户</td><td><code>su - 用户名</code></td></tr><tr><td>半切换到用户</td><td><code>su 用户名</code></td></tr><tr><td>以用户执行命令</td><td><code>sudo -u 用户名 命令</code></td></tr><tr><td>查看当前用户</td><td><code>whoami</code></td></tr><tr><td>退出当前用户</td><td><code>exit</code> 或 <code>Ctrl+D</code></td></tr><tr><td>SSH 登录</td><td><code>ssh 用户名@IP</code></td></tr></tbody></table><hr /><blockquote><p><strong>文档版本：</strong> 2026-07-30</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/linux/Linux账号切换使用手册.txt">点击下载 TXT 版本</a></p></div></div><hr /></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/pm2-usage-guide/</id>
      <title type="text">PM2 使用教程（Node.js 进程守护工具）</title>
      <published>2026-07-30T00:00:00.000Z</published>
      <updated>2026-08-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/pm2-usage-guide/"/>
      <summary type="text">PM2 完整使用指南，涵盖安装、启动配置、进程管理、日志管理、集群模式、开机自启及常见问题排查。</summary>
      <content type="html"><![CDATA[<blockquote><p>PM2 是 Node.js 最常用的进程管理器，可以让你的应用在后台持久运行，支持自动重启、负载均衡、日志管理等功能。</p></blockquote>
<hr />
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%AE%89%E8%A3%85-pm2">安装 PM2</a></li>
<li><a href="#2-%E5%90%AF%E5%8A%A8%E5%BA%94%E7%94%A8">启动应用</a></li>
<li><a href="#3-%E5%B8%B8%E7%94%A8%E7%AE%A1%E7%90%86%E5%91%BD%E4%BB%A4">常用管理命令</a></li>
<li><a href="#4-%E6%97%A5%E5%BF%97%E7%AE%A1%E7%90%86">日志管理</a></li>
<li><a href="#5-%E5%BC%80%E6%9C%BA%E8%87%AA%E5%90%AF">开机自启</a></li>
<li><a href="#6-%E9%9B%86%E7%BE%A4%E6%A8%A1%E5%BC%8F">集群模式</a></li>
<li><a href="#7-%E7%8E%AF%E5%A2%83%E5%8F%98%E9%87%8F">环境变量</a></li>
<li><a href="#8-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98">常见问题</a></li>
<li><a href="#9-%E5%BF%AB%E9%80%9F%E5%8F%82%E8%80%83%E5%8D%A1%E7%89%87">快速参考卡片</a></li>
<li><a href="#10-%E5%AE%8C%E6%95%B4%E9%83%A8%E7%BD%B2%E7%A4%BA%E4%BE%8B">完整部署示例</a></li>
</ol><hr /></section>
<section><h2>1. 安装 PM2<a href="#1-安装-pm2"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 全局安装</span></div></div><div><div><div>2</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>-g</span><span> </span><span>pm2</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 验证安装</span></div></div><div><div><div>5</div></div><div><span>pm2</span><span> </span><span>--version</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>2. 启动应用<a href="#2-启动应用"><span>#</span></a></h2><section><h3>2.1 基础启动<a href="#21-基础启动"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 启动单个文件</span></div></div><div><div><div>2</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 指定应用名称（推荐）</span></div></div><div><div><div>5</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>--name</span><span> </span><span>"my-app"</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 启动时指定参数</span></div></div><div><div><div>8</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>--name</span><span> </span><span>"my-app"</span><span> </span><span>--</span><span> </span><span>--port</span><span> </span><span>3000</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>2.2 使用配置文件启动（推荐）<a href="#22-使用配置文件启动推荐"><span>#</span></a></h3><p>在项目根目录创建 <code>ecosystem.config.js</code>：</p><div><div><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>module</span><span>.</span><span>exports</span><span> </span><span>=</span><span> {</span></div></div><div><div><div>2</div></div><div><span>  </span><span>apps</span><span>:</span><span> [</span></div></div><div><div><div>3</div></div><div><span><span>    </span></span><span>{</span></div></div><div><div><div>4</div></div><div><span>      </span><span>name</span><span>:</span><span> </span><span>'my-app'</span><span>,              </span><span>// 应用名称</span></div></div><div><div><div>5</div></div><div><span>      </span><span>script</span><span>:</span><span> </span><span>'./index.mjs'</span><span>,       </span><span>// 启动文件</span></div></div><div><div><div>6</div></div><div><span>      </span><span>cwd</span><span>:</span><span> </span><span>'/opt/my-project'</span><span>,      </span><span>// 工作目录（可选）</span></div></div><div><div><div>7</div></div><div><span>      </span><span>instances</span><span>:</span><span> </span><span>1</span><span>,                </span><span>// 实例数量（1 或 'max' 使用全部CPU）</span></div></div><div><div><div>8</div></div><div><span>      </span><span>exec_mode</span><span>:</span><span> </span><span>'fork'</span><span>,           </span><span>// 执行模式：fork 或 cluster</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span>      </span><span>// 环境变量</span></div></div><div><div><div>11</div></div><div><span>      </span><span>env</span><span>:</span><span> {</span></div></div><div><div><div>12</div></div><div><span>        </span><span>NODE_ENV</span><span>:</span><span> </span><span>'development'</span><span>,</span></div></div><div><div><div>13</div></div><div><span>        </span><span>PORT</span><span>:</span><span> </span><span>3000</span></div></div><div><div><div>14</div></div><div><span><span>      </span></span><span>},</span></div></div><div><div><div>15</div></div><div><span>      </span><span>env_production</span><span>:</span><span> {</span></div></div><div><div><div>16</div></div><div><span>        </span><span>NODE_ENV</span><span>:</span><span> </span><span>'production'</span><span>,</span></div></div><div><div><div>17</div></div><div><span>        </span><span>PORT</span><span>:</span><span> </span><span>3000</span></div></div><div><div><div>18</div></div><div><span><span>      </span></span><span>},</span></div></div><div><div><div>19</div></div><div>
</div></div><div><div><div>20</div></div><div><span>      </span><span>// 自动重启</span></div></div><div><div><div>21</div></div><div><span>      </span><span>autorestart</span><span>:</span><span> </span><span>true</span><span>,</span></div></div><div><div><div>22</div></div><div>
</div></div><div><div><div>23</div></div><div><span>      </span><span>// 内存限制（超过自动重启）</span></div></div><div><div><div>24</div></div><div><span>      </span><span>max_memory_restart</span><span>:</span><span> </span><span>'500M'</span><span>,</span></div></div><div><div><div>25</div></div><div>
</div></div><div><div><div>26</div></div><div><span>      </span><span>// 日志配置</span></div></div><div><div><div>27</div></div><div><span>      </span><span>log_file</span><span>:</span><span> </span><span>'./logs/combined.log'</span><span>,</span></div></div><div><div><div>28</div></div><div><span>      </span><span>out_file</span><span>:</span><span> </span><span>'./logs/out.log'</span><span>,</span></div></div><div><div><div>29</div></div><div><span>      </span><span>error_file</span><span>:</span><span> </span><span>'./logs/error.log'</span><span>,</span></div></div><div><div><div>30</div></div><div><span>      </span><span>log_date_format</span><span>:</span><span> </span><span>'YYYY-MM-DD HH:mm:ss Z'</span><span>,</span></div></div><div><div><div>31</div></div><div>
</div></div><div><div><div>32</div></div><div><span>      </span><span>// 监听文件变化自动重启（开发环境用）</span></div></div><div><div><div>33</div></div><div><span>      </span><span>watch</span><span>:</span><span> </span><span>false</span><span>,</span></div></div><div><div><div>34</div></div><div><span>      </span><span>ignore_watch</span><span>:</span><span> [</span><span>'node_modules'</span><span>, </span><span>'logs'</span><span>],</span></div></div><div><div><div>35</div></div><div>
</div></div><div><div><div>36</div></div><div><span>      </span><span>// 延迟启动</span></div></div><div><div><div>37</div></div><div><span>      </span><span>restart_delay</span><span>:</span><span> </span><span>3000</span><span>,</span></div></div><div><div><div>38</div></div><div>
</div></div><div><div><div>39</div></div><div><span>      </span><span>// 最大重启次数（防止无限重启）</span></div></div><div><div><div>40</div></div><div><span>      </span><span>max_restarts</span><span>:</span><span> </span><span>10</span><span>,</span></div></div><div><div><div>41</div></div><div>
</div></div><div><div><div>42</div></div><div><span>      </span><span>// 最小运行时间</span></div></div><div><div><div>43</div></div><div><span>      </span><span>min_uptime</span><span>:</span><span> </span><span>'10s'</span></div></div><div><div><div>44</div></div><div><span><span>    </span></span><span>}</span></div></div><div><div><div>45</div></div><div><span><span>  </span></span><span>]</span></div></div><div><div><div>46</div></div><div><span>};</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><p>启动命令：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>ecosystem.config.js</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span># 指定环境</span></div></div><div><div><div>4</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>ecosystem.config.js</span><span> </span><span>--env</span><span> </span><span>production</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>3. 常用管理命令<a href="#3-常用管理命令"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看所有应用状态</span></div></div><div><div><div>2</div></div><div><span>pm2</span><span> </span><span>status</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>pm2</span><span> </span><span>ls</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span>pm2</span><span> </span><span>list</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 查看某个应用详情</span></div></div><div><div><div>9</div></div><div><span>pm2</span><span> </span><span>show</span><span> </span><span>my-app</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span>pm2</span><span> </span><span>describe</span><span> </span><span>my-app</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 查看应用监控面板（实时）</span></div></div><div><div><div>14</div></div><div><span>pm2</span><span> </span><span>monit</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 重启应用</span></div></div><div><div><div>17</div></div><div><span>pm2</span><span> </span><span>restart</span><span> </span><span>my-app</span></div></div><div><div><div>18</div></div><div>
</div></div><div><div><div>19</div></div><div><span>pm2</span><span> </span><span>restart</span><span> </span><span>all</span><span>          </span><span># 重启所有</span></div></div><div><div><div>20</div></div><div>
</div></div><div><div><div>21</div></div><div><span># 停止应用（不删除）</span></div></div><div><div><div>22</div></div><div><span>pm2</span><span> </span><span>stop</span><span> </span><span>my-app</span></div></div><div><div><div>23</div></div><div>
</div></div><div><div><div>24</div></div><div><span>pm2</span><span> </span><span>stop</span><span> </span><span>all</span></div></div><div><div><div>25</div></div><div>
</div></div><div><div><div>26</div></div><div><span># 删除应用</span></div></div><div><div><div>27</div></div><div><span>pm2</span><span> </span><span>delete</span><span> </span><span>my-app</span></div></div><div><div><div>28</div></div><div>
</div></div><div><div><div>29</div></div><div><span>pm2</span><span> </span><span>delete</span><span> </span><span>all</span></div></div><div><div><div>30</div></div><div>
</div></div><div><div><div>31</div></div><div><span># 重载应用（0 停机时间，仅 cluster 模式）</span></div></div><div><div><div>32</div></div><div><span>pm2</span><span> </span><span>reload</span><span> </span><span>my-app</span></div></div><div><div><div>33</div></div><div>
</div></div><div><div><div>34</div></div><div><span># 查看应用日志</span></div></div><div><div><div>35</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span></div></div><div><div><div>36</div></div><div>
</div></div><div><div><div>37</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span><span> </span><span>--lines</span><span> </span><span>50</span><span>    </span><span># 查看最新50行</span></div></div><div><div><div>38</div></div><div>
</div></div><div><div><div>39</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>--lines</span><span> </span><span>100</span><span>           </span><span># 查看所有应用最新100行</span></div></div><div><div><div>40</div></div><div>
</div></div><div><div><div>41</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span><span> </span><span>--timestamp</span><span>    </span><span># 带时间戳</span></div></div><div><div><div>42</div></div><div>
</div></div><div><div><div>43</div></div><div><span># 清空日志（全局操作，不支持按应用）</span></div></div><div><div><div>44</div></div><div><span>pm2</span><span> </span><span>flush</span></div></div><div><div><div>45</div></div><div>
</div></div><div><div><div>46</div></div><div><span># 保存当前进程列表（用于开机自启）</span></div></div><div><div><div>47</div></div><div><span>pm2</span><span> </span><span>save</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><div><div><div></div><div>WARNING</div></div><div><p><code>pm2 flush my-app</code> 这种按应用清空日志的写法<strong>无效</strong>，<code>flush</code> 是全局操作，会清空所有应用的日志。</p></div></div><hr /></section>
<section><h2>4. 日志管理<a href="#4-日志管理"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 实时查看日志</span></div></div><div><div><div>2</div></div><div><span>pm2</span><span> </span><span>logs</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看指定应用日志</span></div></div><div><div><div>5</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 查看历史日志（带行数限制）</span></div></div><div><div><div>8</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span><span> </span><span>--lines</span><span> </span><span>200</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 只查看错误日志</span></div></div><div><div><div>11</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span><span> </span><span>--err</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 只查看标准输出</span></div></div><div><div><div>14</div></div><div><span>pm2</span><span> </span><span>logs</span><span> </span><span>my-app</span><span> </span><span>--out</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>日志文件默认位置：</strong></p>

<table><thead><tr><th>路径</th><th>说明</th></tr></thead><tbody><tr><td><code>~/.pm2/logs/</code></td><td>全局日志目录</td></tr><tr><td><code>./logs/</code></td><td>如果在配置中指定了相对路径</td></tr></tbody></table><hr /></section>
<section><h2>5. 开机自启<a href="#5-开机自启"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 生成开机启动脚本（根据系统类型自动生成）</span></div></div><div><div><div>2</div></div><div><span>pm2</span><span> </span><span>startup</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 执行输出的命令（需要 root 权限）</span></div></div><div><div><div>5</div></div><div><span># 例如：sudo env PATH=$PATH:/usr/bin pm2 startup systemd -u username --hp /home/username</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 保存当前运行的进程列表</span></div></div><div><div><div>8</div></div><div><span>pm2</span><span> </span><span>save</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 取消开机自启</span></div></div><div><div><div>11</div></div><div><span>pm2</span><span> </span><span>unstartup</span><span> </span><span>systemd</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>IMPORTANT</div></div><div><p><code>pm2 startup</code> 只是生成命令，<strong>必须复制并执行它输出的那行命令</strong>才能真正生效。</p></div></div><hr /></section>
<section><h2>6. 集群模式（多核利用）<a href="#6-集群模式多核利用"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 启动多个实例，利用全部 CPU 核心</span></div></div><div><div><div>2</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>-i</span><span> </span><span>max</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 或指定实例数</span></div></div><div><div><div>5</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>-i</span><span> </span><span>4</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>在 <code>ecosystem.config.js</code> 中配置：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span><span>instances</span><span>: </span></span><span>'max'</span><span>,</span></div></div><div><div><div>2</div></div><div><span><span>exec_mode</span><span>: </span></span><span>'cluster'</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>7. 环境变量<a href="#7-环境变量"><span>#</span></a></h2><p><strong>启动时传入环境变量：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>--name</span><span> </span><span>"my-app"</span><span> </span><span>--env</span><span> </span><span>production</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>在 <code>ecosystem.config.js</code> 中定义：</strong></p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span><span>env</span><span>: {</span></span></div></div><div><div><div>2</div></div><div><span><span>  </span></span><span>NODE_ENV</span><span>: </span><span>'development'</span><span>,</span></div></div><div><div><div>3</div></div><div><span><span>  </span></span><span>PORT</span><span>: </span><span>3000</span><span>,</span></div></div><div><div><div>4</div></div><div><span><span>  </span></span><span>DATABASE_URL</span><span>: </span><span>'mysql://localhost:3306/mydb'</span></div></div><div><div><div>5</div></div><div><span>}</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>TIP</div></div><div><p>环境变量建议在 <code>ecosystem.config.js</code> 中集中管理，不要在命令行里写一堆 <code>--env</code>。</p></div></div><hr /></section>
<section><h2>8. 常见问题<a href="#8-常见问题"><span>#</span></a></h2><section><h3>Q1: pm2 启动后访问不了？<a href="#q1-pm2-启动后访问不了"><span>#</span></a></h3><ul>
<li>检查应用是否监听 <code>0.0.0.0</code>（不能仅监听 <code>127.0.0.1</code>）</li>
<li>检查防火墙是否放行端口</li>
<li>查看日志：<code>pm2 logs my-app</code></li>
</ul></section><section><h3>Q2: 修改代码后如何生效？<a href="#q2-修改代码后如何生效"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pm2</span><span> </span><span>restart</span><span> </span><span>my-app</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>开发环境可开启 watch 模式：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>--watch</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>Q3: 如何更新 PM2？<a href="#q3-如何更新-pm2"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>npm</span><span> </span><span>install</span><span> </span><span>-g</span><span> </span><span>pm2@latest</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>pm2</span><span> </span><span>update</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>Q4: 服务器重启后应用没了？<a href="#q4-服务器重启后应用没了"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>pm2</span><span> </span><span>save</span><span>        </span><span># 保存进程列表</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>pm2</span><span> </span><span>startup</span><span>    </span><span># 设置开机自启（记得执行输出的命令）</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>9. 快速参考卡片<a href="#9-快速参考卡片"><span>#</span></a></h2>

<table><thead><tr><th>命令</th><th>作用</th></tr></thead><tbody><tr><td><code>pm2 start app.js</code></td><td>启动应用</td></tr><tr><td><code>pm2 start app.js --name "xxx"</code></td><td>指定名称启动</td></tr><tr><td><code>pm2 status</code> / <code>ls</code> / <code>list</code></td><td>查看状态</td></tr><tr><td><code>pm2 restart xxx</code></td><td>重启</td></tr><tr><td><code>pm2 stop xxx</code></td><td>停止</td></tr><tr><td><code>pm2 delete xxx</code></td><td>删除</td></tr><tr><td><code>pm2 logs xxx</code></td><td>查看日志</td></tr><tr><td><code>pm2 monit</code></td><td>监控面板</td></tr><tr><td><code>pm2 save</code></td><td>保存进程列表</td></tr><tr><td><code>pm2 startup</code></td><td>设置开机自启</td></tr><tr><td><code>pm2 flush</code></td><td>清空日志</td></tr></tbody></table><hr /></section>
<section><h2>10. 完整部署示例<a href="#10-完整部署示例"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. 进入项目目录</span></div></div><div><div><div>2</div></div><div><span>cd</span><span> </span><span>/opt/my-project</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 2. 安装依赖</span></div></div><div><div><div>5</div></div><div><span>npm</span><span> </span><span>install</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 3. 用 pm2 启动</span></div></div><div><div><div>8</div></div><div><span>pm2</span><span> </span><span>start</span><span> </span><span>index.mjs</span><span> </span><span>--name</span><span> </span><span>"my-app"</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 4. 保存进程列表</span></div></div><div><div><div>11</div></div><div><span>pm2</span><span> </span><span>save</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 5. 设置开机自启（复制并执行输出的命令）</span></div></div><div><div><div>14</div></div><div><span>pm2</span><span> </span><span>startup</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 6. 查看状态确认</span></div></div><div><div><div>17</div></div><div><span>pm2</span><span> </span><span>status</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /><blockquote><p><strong>文档版本：</strong> 2026-07-30</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/linux/PM2使用教程.txt">点击下载 TXT 版本</a></p></div></div><hr /></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/ssh-complete-guide/</id>
      <title type="text">SSH 完整配置指南（Debian / Ubuntu）</title>
      <published>2026-07-30T00:00:00.000Z</published>
      <updated>2026-08-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/ssh-complete-guide/"/>
      <summary type="text">面向新手的 SSH 完整配置教程，涵盖创建用户、修改端口、密钥登录、防火墙配置、故障排查及用户删除，适用于 Debian / Ubuntu 服务器。</summary>
      <content type="html"><![CDATA[<blockquote><p>本文档面向从零开始配置 SSH 的新手，涵盖服务器端创建用户、修改配置、密钥登录，以及客户端连接的全流程。
<strong>适用系统：</strong> Debian 11+ / Ubuntu 20.04+<br />
<strong>适用平台：</strong> 腾讯云 CVM / 任何支持 SSH 的 Linux 服务器</p></blockquote>
<hr />
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%89%8D%E7%BD%AE%E6%A3%80%E6%9F%A5%E7%A1%AE%E8%AE%A4-ssh-%E6%9C%8D%E5%8A%A1%E7%8A%B6%E6%80%81">前置检查：确认 SSH 服务状态</a></li>
<li><a href="#2-%E5%88%9B%E5%BB%BA%E6%99%AE%E9%80%9A%E7%94%A8%E6%88%B7%E7%A6%81%E6%AD%A2-root-%E7%99%BB%E5%BD%95">创建普通用户（禁止 root 登录）</a></li>
<li><a href="#3-%E4%BF%AE%E6%94%B9-ssh-%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6">修改 SSH 配置文件</a></li>
<li><a href="#4-%E9%98%B2%E7%81%AB%E5%A2%99%E4%B8%8E%E5%AE%89%E5%85%A8%E7%BB%84">防火墙与安全组</a></li>
<li><a href="#5-%E5%AE%A2%E6%88%B7%E7%AB%AF%E8%BF%9E%E6%8E%A5%E6%B5%8B%E8%AF%95">客户端连接测试</a></li>
<li><a href="#6-%E5%AF%86%E9%92%A5%E7%99%BB%E5%BD%95%E6%AF%94%E5%AF%86%E7%A0%81%E6%9B%B4%E5%AE%89%E5%85%A8">密钥登录（比密码更安全）</a></li>
<li><a href="#7-%E9%AB%98%E7%BA%A7%E9%85%8D%E7%BD%AE%E9%80%89%E9%A1%B9">高级配置选项</a></li>
<li><a href="#8-%E6%95%85%E9%9A%9C%E6%8E%92%E6%9F%A5">故障排查</a></li>
<li><a href="#9-windows-%E5%AE%89%E8%A3%85-ssh-%E5%AE%A2%E6%88%B7%E7%AB%AF">Windows 安装 SSH 客户端</a></li>
<li><a href="#10-%E5%88%A0%E9%99%A4%E7%94%A8%E6%88%B7">删除用户</a></li>
<li><a href="#11-%E5%AE%8C%E6%95%B4%E5%91%BD%E4%BB%A4%E9%80%9F%E6%9F%A5%E8%A1%A8">完整命令速查表</a></li>
</ol><hr /></section>
<section><h2>1. 前置检查：确认 SSH 服务状态<a href="#1-前置检查确认-ssh-服务状态"><span>#</span></a></h2><section><h3>1.1 检查 SSH 是否运行<a href="#11-检查-ssh-是否运行"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>status</span><span> </span><span>ssh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>输出解读：</strong></p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>● ssh.service - OpenSSH server</span></div></div><div><div><div>2</div></div><div><span><span>   </span></span><span>Loaded: loaded (/lib/systemd/system/ssh.service; enabled; vendor preset: enabled)</span></div></div><div><div><div>3</div></div><div><span><span>   </span></span><span>Active: active (running) since Mon 2026-07-13 02:55:39 UTC; 5min ago</span></div></div></code></pre><div><div></div><div></div></div></figure></div>

<table><thead><tr><th>字段</th><th>含义</th></tr></thead><tbody><tr><td><code>Active: active (running)</code></td><td>✅ SSH 服务正在运行</td></tr><tr><td><code>Loaded: ... enabled</code></td><td>✅ 开机自启动已启用</td></tr><tr><td><code>vendor preset: enabled</code></td><td>系统默认就启用了</td></tr></tbody></table><p>如果显示 <code>inactive</code>（未运行）：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 安装 OpenSSH 服务端（Debian 默认已装）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>update</span></div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>openssh-server</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 启动并设置开机自启</span></div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>enable</span><span> </span><span>ssh</span><span> </span><span>--now</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 再次检查</span></div></div><div><div><div>9</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>status</span><span> </span><span>ssh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>TIP</div></div><div><p><code>-now</code> 是 <code>--now</code> 的简写，等价于先 <code>enable</code> 再 <code>start</code>，一步完成。</p></div></div><hr /></section></section>
<section><h2>2. 创建普通用户（禁止 root 登录）<a href="#2-创建普通用户禁止-root-登录"><span>#</span></a></h2><section><h3>2.1 为什么不能用 root 登录？<a href="#21-为什么不能用-root-登录"><span>#</span></a></h3><ul>
<li><strong>root 是超级管理员</strong>，权限过大，误操作会直接毁掉系统</li>
<li><strong>root 用户名是公开的</strong>，黑客扫描时第一个尝试的就是 root + 弱密码</li>
<li><strong>日志审计困难</strong>，所有 root 操作混在一起，无法区分是谁干的</li>
</ul></section><section><h3>2.2 创建用户<a href="#22-创建用户"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>adduser</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>交互过程：</strong></p><div><div><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>Adding user 'qtfy' ...</span></div></div><div><div><div>2</div></div><div><span>Adding new group 'qtfy' (1000) ...</span></div></div><div><div><div>3</div></div><div><span>Adding new user 'qtfy' (1000) with group 'qtfy' ...</span></div></div><div><div><div>4</div></div><div><span>Creating home directory '/home/qtfy' ...</span></div></div><div><div><div>5</div></div><div><span>Copying files from '/etc/skel' ...</span></div></div><div><div><div>6</div></div><div><span>New password:                    ← 输入密码（不显示字符）</span></div></div><div><div><div>7</div></div><div><span>Retype new password:             ← 再次输入确认</span></div></div><div><div><div>8</div></div><div><span>passwd: password updated successfully</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span>Changing the user information for qtfy</span></div></div><div><div><div>11</div></div><div><span>Full Name []:                    ← 按回车跳过</span></div></div><div><div><div>12</div></div><div><span>Room Number []:                  ← 按回车跳过</span></div></div><div><div><div>13</div></div><div><span>Work Phone []:                   ← 按回车跳过</span></div></div><div><div><div>14</div></div><div><span>Home Phone []:                   ← 按回车跳过</span></div></div><div><div><div>15</div></div><div><span>Other []:                        ← 按回车跳过</span></div></div><div><div><div>16</div></div><div>
</div></div><div><div><div>17</div></div><div><span>Is the information correct? [Y/n]  ← 按回车确认（默认 Y）</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><p><strong>命令详解：</strong></p>

<table><thead><tr><th>命令</th><th>作用</th><th>与 <code>useradd</code> 的区别</th></tr></thead><tbody><tr><td><code>adduser</code></td><td>交互式创建用户，自动创建家目录、复制配置文件</td><td>更友好，推荐新手使用</td></tr><tr><td><code>useradd</code></td><td>底层命令，只创建用户条目，不创建家目录</td><td>需要额外参数 <code>-m</code> 才创建家目录</td></tr></tbody></table><p><code>adduser</code> 自动做了什么：</p><ul>
<li>创建用户账户 <code>/etc/passwd</code></li>
<li>创建用户组 <code>/etc/group</code></li>
<li>创建家目录 <code>/home/qtfy</code></li>
<li>从 <code>/etc/skel</code> 复制默认配置文件（如 <code>.bashrc</code>）</li>
<li>设置密码</li>
</ul></section><section><h3>2.3 赋予 sudo 权限<a href="#23-赋予-sudo-权限"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>usermod</span><span> </span><span>-aG</span><span> </span><span>sudo</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>参数详解：</strong></p>

<table><thead><tr><th>参数</th><th>全称</th><th>含义</th></tr></thead><tbody><tr><td><code>-a</code></td><td><code>--append</code></td><td>追加到组，而不是覆盖原有组</td></tr><tr><td><code>-G</code></td><td><code>--groups</code></td><td>指定要加入的附加组</td></tr><tr><td><code>sudo</code></td><td>组名</td><td>Debian 中拥有 sudo 权限的默认组</td></tr></tbody></table><div><div><div></div><div>WARNING</div></div><div><p><strong>如果不加 <code>-a</code></strong>，<code>-G</code> 会覆盖用户的所有附加组，导致用户从其他组中被移除。</p></div></div><p><strong>验证 sudo 权限：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>su</span><span> </span><span>-</span><span> </span><span>qtfy</span><span>          </span><span># 切换到 qtfy 用户</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>whoami</span><span>        </span><span># 测试 sudo</span></div></div><div><div><div>3</div></div><div><span># 输出：root（表示 sudo 生效）</span></div></div><div><div><div>4</div></div><div><span>exit</span><span>               </span><span># 返回 root</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>3. 修改 SSH 配置文件<a href="#3-修改-ssh-配置文件"><span>#</span></a></h2><section><h3>3.1 打开配置文件<a href="#31-打开配置文件"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>nano</span><span> </span><span>/etc/ssh/sshd_config</span></div></div></code></pre><div><div></div><div></div></div></figure></div><blockquote><p><code>sshd_config</code> 是 SSH <strong>服务端</strong>（daemon）的配置文件。还有一个 <code>ssh_config</code> 是客户端配置，不要搞混。</p></blockquote></section><section><h3>3.2 关键配置项详解<a href="#32-关键配置项详解"><span>#</span></a></h3><section><h4>① Port —— 修改监听端口<a href="#-port--修改监听端口"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 找到这行（默认被注释）</span></div></div><div><div><div>2</div></div><div><span>#Port 22</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 修改为（1024-65535 之间任意未占用端口）</span></div></div><div><div><div>5</div></div><div><span>Port</span><span> </span><span>2222</span></div></div></code></pre><div><div></div><div></div></div></figure></div>

<table><thead><tr><th>选项</th><th>说明</th></tr></thead><tbody><tr><td><code>Port 22</code></td><td>默认端口，全球扫描器都在扫这个端口</td></tr><tr><td><code>Port 2222</code></td><td>常见替代端口，仍有一定扫描量</td></tr><tr><td><code>Port 49152</code></td><td>动态/私有端口范围，扫描量更低</td></tr><tr><td><code>Port 22</code> + 密钥登录</td><td>如果必须用 22，建议配合密钥 + fail2ban</td></tr></tbody></table><blockquote><p>查看端口是否被占用：<code>sudo ss -tlnp | grep 2222</code></p></blockquote></section><section><h4>② PermitRootLogin —— 是否允许 root 登录<a href="#-permitrootlogin--是否允许-root-登录"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 找到这行</span></div></div><div><div><div>2</div></div><div><span>#PermitRootLogin prohibit-password</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 修改为</span></div></div><div><div><div>5</div></div><div><span>PermitRootLogin</span><span> </span><span>no</span></div></div></code></pre><div><div></div><div></div></div></figure></div>

<table><thead><tr><th>值</th><th>含义</th></tr></thead><tbody><tr><td><code>yes</code></td><td>允许 root 用密码或密钥登录（最危险）</td></tr><tr><td><code>no</code></td><td>完全禁止 root 登录（推荐）</td></tr><tr><td><code>prohibit-password</code></td><td>允许 root 用密钥登录，禁止密码登录</td></tr><tr><td><code>without-password</code></td><td>同 <code>prohibit-password</code>（旧写法）</td></tr><tr><td><code>forced-commands-only</code></td><td>只允许 root 执行预定义命令</td></tr></tbody></table></section><section><h4>③ PasswordAuthentication —— 是否允许密码登录<a href="#-passwordauthentication--是否允许密码登录"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>PasswordAuthentication</span><span> </span><span>yes</span></div></div></code></pre><div><div></div><div></div></div></figure></div>

<table><thead><tr><th>阶段</th><th>建议值</th><th>原因</th></tr></thead><tbody><tr><td>初始配置</td><td><code>yes</code></td><td>先确保能用密码连上，再配密钥</td></tr><tr><td>密钥配好后</td><td><code>no</code></td><td>关闭密码，只接受密钥登录</td></tr></tbody></table><blockquote><p>先配好密钥并测试成功，再改 <code>no</code>。否则可能把自己锁在服务器外。</p></blockquote></section><section><h4>④ PubkeyAuthentication —— 是否允许密钥登录<a href="#-pubkeyauthentication--是否允许密钥登录"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>PubkeyAuthentication</span><span> </span><span>yes</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>默认就是 <code>yes</code>，确保这行没有被注释或改成 <code>no</code>。</p></section><section><h4>⑤ AllowUsers —— 只允许特定用户登录（可选）<a href="#-allowusers--只允许特定用户登录可选"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>AllowUsers</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>作用：</strong> 即使有人知道其他用户名（如 <code>test</code>、<code>admin</code>），也无法通过 SSH 登录。是最后一道防线。</p><p><strong>多个用户：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>AllowUsers</span><span> </span><span>qtfy</span><span> </span><span>alice</span><span> </span><span>bob</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h4>⑥ MaxAuthTries —— 最大尝试次数（防暴力破解）<a href="#-maxauthtries--最大尝试次数防暴力破解"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>MaxAuthTries</span><span> </span><span>3</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>连续输错 3 次密码后，当前连接会被断开。</p></section><section><h4>⑦ ClientAliveInterval —— 保持连接（防超时断开）<a href="#-clientaliveinterval--保持连接防超时断开"><span>#</span></a></h4><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ClientAliveInterval</span><span> </span><span>60</span></div></div><div><div><div>2</div></div><div><span>ClientAliveCountMax</span><span> </span><span>3</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>每 60 秒发送一次心跳包，连续 3 次无响应才断开。适合长时间操作（如编译、传输大文件）。</p></section></section><section><h3>3.3 配置示例（推荐的安全配置）<a href="#33-配置示例推荐的安全配置"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 基础设置</span></div></div><div><div><div>2</div></div><div><span>Port</span><span> </span><span>2222</span></div></div><div><div><div>3</div></div><div><span>ListenAddress</span><span> </span><span>0.0.0.0</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 认证设置</span></div></div><div><div><div>6</div></div><div><span>PermitRootLogin</span><span> </span><span>no</span></div></div><div><div><div>7</div></div><div><span>PasswordAuthentication</span><span> </span><span>yes</span><span>        </span><span># 初始阶段用 yes，密钥配好后改 no</span></div></div><div><div><div>8</div></div><div><span>PubkeyAuthentication</span><span> </span><span>yes</span></div></div><div><div><div>9</div></div><div><span>MaxAuthTries</span><span> </span><span>3</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span># 可选：只允许特定用户</span></div></div><div><div><div>12</div></div><div><span>AllowUsers</span><span> </span><span>qtfy</span></div></div><div><div><div>13</div></div><div>
</div></div><div><div><div>14</div></div><div><span># 会话保持</span></div></div><div><div><div>15</div></div><div><span>ClientAliveInterval</span><span> </span><span>60</span></div></div><div><div><div>16</div></div><div><span>ClientAliveCountMax</span><span> </span><span>3</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span># 禁用不安全的算法（可选，高级）</span></div></div><div><div><div>19</div></div><div><span>Ciphers</span><span> </span><span>chacha20-poly1305@openssh.com,aes256-gcm@openssh.com</span></div></div><div><div><div>20</div></div><div><span>MACs</span><span> </span><span>hmac-sha2-512-etm@openssh.com,hmac-sha2-256-etm@openssh.com</span></div></div><div><div><div>21</div></div><div><span>KexAlgorithms</span><span> </span><span>curve25519-sha256,curve25519-sha256@libssh.org</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>3.4 保存并重启 SSH<a href="#34-保存并重启-ssh"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 检查配置文件语法是否正确（重要！）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>sshd</span><span> </span><span>-t</span></div></div><div><div><div>3</div></div><div><span># 无输出 = 语法正确</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 重启 SSH 服务</span></div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>restart</span><span> </span><span>ssh</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 确认重启后状态正常</span></div></div><div><div><div>9</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>status</span><span> </span><span>ssh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>TIP</div></div><div><p><code>sshd -t</code> 是测试模式，只检查语法不启动服务。如果配置有错，它会报错并拒绝重启，避免把自己锁在外面。</p></div></div><hr /></section></section>
<section><h2>4. 防火墙与安全组<a href="#4-防火墙与安全组"><span>#</span></a></h2><section><h3>4.1 服务器本地防火墙（ufw）<a href="#41-服务器本地防火墙ufw"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 安装 ufw（Debian 默认可能没装）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>ufw</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 默认策略：拒绝所有入站，允许所有出站</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>deny</span><span> </span><span>incoming</span></div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>allow</span><span> </span><span>outgoing</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 放行 SSH 端口（如果你改成了 2222）</span></div></div><div><div><div>9</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>2222/tcp</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span># 如果还开了其他服务（如 HTTP）</span></div></div><div><div><div>12</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>80/tcp</span></div></div><div><div><div>13</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>443/tcp</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span># 启用防火墙</span></div></div><div><div><div>16</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>enable</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span># 查看状态</span></div></div><div><div><div>19</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span><span> </span><span>verbose</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><p><strong>ufw 常用命令：</strong></p>

<table><thead><tr><th>命令</th><th>作用</th></tr></thead><tbody><tr><td><code>sudo ufw allow 2222/tcp</code></td><td>放行 TCP 2222 端口</td></tr><tr><td><code>sudo ufw allow from 192.168.1.0/24 to any port 2222</code></td><td>只允许特定网段访问</td></tr><tr><td><code>sudo ufw delete allow 2222/tcp</code></td><td>删除规则</td></tr><tr><td><code>sudo ufw disable</code></td><td>临时关闭防火墙</td></tr><tr><td><code>sudo ufw reset</code></td><td>重置所有规则</td></tr></tbody></table></section><section><h3>4.2 腾讯云安全组（必须！）<a href="#42-腾讯云安全组必须"><span>#</span></a></h3><p>这是云服务商层面的防火墙，<strong>优先级高于 ufw</strong>。如果安全组没放行，ufw 放行了也连不上。</p><p><strong>配置路径：</strong></p><p>腾讯云控制台 → 云服务器 CVM → 实例详情 → 安全组 → 入站规则 → 添加规则</p>

<table><thead><tr><th>配置项</th><th>值</th></tr></thead><tbody><tr><td>来源</td><td><code>0.0.0.0/0</code>（任何 IP）或你的公网 IP</td></tr><tr><td>协议端口</td><td>自定义 TCP，端口 <code>2222</code>（或你设的端口）</td></tr><tr><td>策略</td><td>允许</td></tr><tr><td>备注</td><td>SSH 远程登录</td></tr></tbody></table><div><div><div></div><div>IMPORTANT</div></div><div><p><strong>建议</strong>：来源不要写 <code>0.0.0.0/0</code>，改成你当前网络的公网 IP（查 IP：<a href="https://ip.sb" target="_blank">ip.sb</a>）。这样只有你能连，大幅降低被扫描风险。</p></div></div><hr /></section></section>
<section><h2>5. 客户端连接测试<a href="#5-客户端连接测试"><span>#</span></a></h2><section><h3>5.1 Windows（PowerShell / CMD）<a href="#51-windowspowershell--cmd"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 基础连接</span></div></div><div><div><div>2</div></div><div><span><span>ssh </span><span>-</span><span>p </span></span><span>2222</span><span> qtfy</span><span>@你的服务器公网IP</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 示例</span></div></div><div><div><div>5</div></div><div><span><span>ssh </span><span>-</span><span>p </span></span><span>2222</span><span> qtfy</span><span>@123.456.78.90</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>首次连接提示：</strong></p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>The authenticity of host '[123.456.78.90]:2222' can't be established.</span></div></div><div><div><div>2</div></div><div><span>ED25519 key fingerprint is SHA256:xxxxxxxxxxxxxxxx.</span></div></div><div><div><div>3</div></div><div><span>Are you sure you want to continue connecting (yes/no/[fingerprint])?</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>输入 <code>yes</code> 回车。这是把服务器的公钥指纹保存到本地 <code>~/.ssh/known_hosts</code>。</p></section><section><h3>5.2 macOS / Linux<a href="#52-macos--linux"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>qtfy@你的服务器公网IP</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>5.3 常用 SSH 客户端参数<a href="#53-常用-ssh-客户端参数"><span>#</span></a></h3>

<table><thead><tr><th>参数</th><th>作用</th><th>示例</th></tr></thead><tbody><tr><td><code>-p</code></td><td>指定端口</td><td><code>ssh -p 2222 user@ip</code></td></tr><tr><td><code>-i</code></td><td>指定私钥文件</td><td><code>ssh -i ~/.ssh/id_ed25519 user@ip</code></td></tr><tr><td><code>-v</code></td><td>详细模式（排查问题）</td><td><code>ssh -v user@ip</code></td></tr><tr><td><code>-vv</code></td><td>更详细</td><td><code>ssh -vv user@ip</code></td></tr><tr><td><code>-N</code></td><td>不执行远程命令（只做端口转发）</td><td><code>ssh -N -L ...</code></td></tr><tr><td><code>-L</code></td><td>本地端口转发</td><td><code>ssh -L 8080:localhost:80 user@ip</code></td></tr></tbody></table><hr /></section></section>
<section><h2>6. 密钥登录（比密码更安全）<a href="#6-密钥登录比密码更安全"><span>#</span></a></h2><section><h3>6.1 客户端生成密钥对<a href="#61-客户端生成密钥对"><span>#</span></a></h3><p><strong>Windows（PowerShell）：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span><span>ssh</span><span>-</span><span>keygen </span><span>-</span><span>t ed25519 </span><span>-</span><span>C </span></span><span>"qtfy@example.com"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>macOS / Linux：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh-keygen</span><span> </span><span>-t</span><span> </span><span>ed25519</span><span> </span><span>-C</span><span> </span><span>"qtfy@example.com"</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>交互过程：</strong></p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>Generating public/private ed25519 key pair.</span></div></div><div><div><div>2</div></div><div><span>Enter file in which to save the key (/home/qtfy/.ssh/id_ed25519):  ← 按回车用默认路径</span></div></div><div><div><div>3</div></div><div><span>Enter passphrase (empty for no passphrase):                         ← 可选：设置密码保护私钥</span></div></div><div><div><div>4</div></div><div><span>Enter same passphrase again:</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span>Your identification has been saved in /home/qtfy/.ssh/id_ed25519</span></div></div><div><div><div>7</div></div><div><span>Your public key has been saved in /home/qtfy/.ssh/id_ed25519.pub</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>密钥类型选择：</strong></p>

<table><thead><tr><th>类型</th><th>安全性</th><th>速度</th><th>兼容性</th><th>推荐度</th></tr></thead><tbody><tr><td><code>ed25519</code></td><td>⭐⭐⭐</td><td>最快</td><td>现代系统都支持</td><td>✅ 首选</td></tr><tr><td><code>rsa</code></td><td>⭐⭐⭐</td><td>慢</td><td>最广泛</td><td>旧系统兼容用</td></tr><tr><td><code>ecdsa</code></td><td>⭐⭐</td><td>中等</td><td>中等</td><td>不推荐</td></tr><tr><td><code>dsa</code></td><td>⭐</td><td>快</td><td>已废弃</td><td>❌ 禁用</td></tr></tbody></table><p><strong>私钥密码（passphrase）的权衡：</strong></p><ul>
<li><strong>不设密码</strong>：方便，但私钥文件泄露 = 服务器直接沦陷</li>
<li><strong>设密码</strong>：每次使用私钥都要输密码，但更安全。可用 <code>ssh-agent</code> 缓存密码</li>
</ul></section><section><h3>6.2 把公钥传到服务器<a href="#62-把公钥传到服务器"><span>#</span></a></h3><p><strong>方法一：ssh-copy-id（推荐）</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh-copy-id</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>-i</span><span> </span><span>~/.ssh/id_ed25519.pub</span><span> </span><span>qtfy@你的服务器公网IP</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>输入一次密码后，公钥自动复制到服务器的 <code>~/.ssh/authorized_keys</code>。</p><div><div><div></div><div>注意</div></div><div><ul>
<li>需要通过ssh连接后执行，可能需要sudo权限。</li>
</ul></div></div><p><strong>方法二：手动复制</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 本地电脑：复制公钥内容</span></div></div><div><div><div>2</div></div><div><span>cat</span><span> </span><span>~/.ssh/id_ed25519.pub</span></div></div><div><div><div>3</div></div><div><span># 复制输出的那一长串</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 服务器上（用密码登录后）</span></div></div><div><div><div>6</div></div><div><span>mkdir</span><span> </span><span>-p</span><span> </span><span>~/.ssh</span></div></div><div><div><div>7</div></div><div><span>chmod</span><span> </span><span>700</span><span> </span><span>~/.ssh</span></div></div><div><div><div>8</div></div><div><span>echo</span><span> </span><span>"粘贴公钥内容"</span><span> &gt;&gt; </span><span>~/.ssh/authorized_keys</span></div></div><div><div><div>9</div></div><div><span>chmod</span><span> </span><span>600</span><span> </span><span>~/.ssh/authorized_keys</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>6.3 测试密钥登录<a href="#63-测试密钥登录"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>qtfy@你的服务器公网IP</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>如果不需要输密码直接登录成功，密钥配置完成。</p></section><section><h3>6.4 关闭密码登录（密钥确认可用后再执行！）<a href="#64-关闭密码登录密钥确认可用后再执行"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>nano</span><span> </span><span>/etc/ssh/sshd_config</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>修改：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>PasswordAuthentication</span><span> </span><span>no</span></div></div><div><div><div>2</div></div><div><span>ChallengeResponseAuthentication</span><span> </span><span>no</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>重启：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>restart</span><span> </span><span>ssh</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>CAUTION</div></div><div><p><strong>警告</strong>：确保密钥能正常使用再关闭密码！否则会被永久锁在服务器外，只能通过云服务商的 VNC 控制台救回。</p></div></div></section><section><h3>6.5 使用 ssh-agent（避免每次输私钥密码）<a href="#65-使用-ssh-agent避免每次输私钥密码"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 启动 ssh-agent</span></div></div><div><div><div>2</div></div><div><span>eval</span><span> </span><span>"$(</span><span>ssh-agent</span><span> </span><span>-s</span><span>)"</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 添加私钥（如果设了 passphrase，这里输一次）</span></div></div><div><div><div>5</div></div><div><span>ssh-add</span><span> </span><span>~/.ssh/id_ed25519</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 现在连接不需要再输密码</span></div></div><div><div><div>8</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>qtfy@你的服务器公网IP</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>Windows 自动启动 ssh-agent：</strong></p><p>PowerShell 管理员运行：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 确保 ssh-agent 服务自动启动</span></div></div><div><div><div>2</div></div><div><span>Get-Service</span><span><span> ssh</span><span>-</span><span>agent | </span></span><span>Set-Service</span><span><span> </span><span>-</span><span>StartupType Automatic</span></span></div></div><div><div><div>3</div></div><div><span>Start-Service</span><span><span> ssh</span><span>-</span><span>agent</span></span></div></div><div><div><div>4</div></div><div><span><span>ssh</span><span>-</span><span>add </span></span><span>$env:USERPROFILE</span><span>\.ssh\id_ed25519</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>7. 高级配置选项<a href="#7-高级配置选项"><span>#</span></a></h2><section><h3>7.1 SSH 配置文件（客户端）<a href="#71-ssh-配置文件客户端"><span>#</span></a></h3><p>在本地电脑创建 <code>~/.ssh/config</code>（Windows 是 <code>%USERPROFILE%\.ssh\config</code>）：</p><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>Host myserver</span></div></div><div><div><div>2</div></div><div><span><span>    </span></span><span>HostName 123.456.78.90</span></div></div><div><div><div>3</div></div><div><span><span>    </span></span><span>User qtfy</span></div></div><div><div><div>4</div></div><div><span><span>    </span></span><span>Port 2222</span></div></div><div><div><div>5</div></div><div><span><span>    </span></span><span>IdentityFile ~/.ssh/id_ed25519</span></div></div><div><div><div>6</div></div><div><span><span>    </span></span><span>ServerAliveInterval 60</span></div></div><div><div><div>7</div></div><div><span><span>    </span></span><span>ServerAliveCountMax 3</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>然后简化为：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh</span><span> </span><span>myserver</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>7.2 禁止空密码登录<a href="#72-禁止空密码登录"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>PermitEmptyPasswords</span><span> </span><span>no</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>7.3 设置登录欢迎信息<a href="#73-设置登录欢迎信息"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>nano</span><span> </span><span>/etc/ssh/sshd_config</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>添加：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>Banner</span><span> </span><span>/etc/ssh/banner</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>创建 banner 文件：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>nano</span><span> </span><span>/etc/ssh/banner</span></div></div><div><div><div>2</div></div><div><span># 写入：</span></div></div><div><div><div>3</div></div><div><span># =========================================</span></div></div><div><div><div>4</div></div><div><span>#  Authorized access only!</span></div></div><div><div><div>5</div></div><div><span>#  All activity may be monitored.</span></div></div><div><div><div>6</div></div><div><span># =========================================</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>7.4 记录详细日志<a href="#74-记录详细日志"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 在 sshd_config 中</span></div></div><div><div><div>2</div></div><div><span>LogLevel</span><span> </span><span>VERBOSE</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p>查看登录日志：</p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>tail</span><span> </span><span>-f</span><span> </span><span>/var/log/auth.log</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>7.5 使用 fail2ban（自动封禁暴力破解 IP）<a href="#75-使用-fail2ban自动封禁暴力破解-ip"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>fail2ban</span></div></div><div><div><div>2</div></div><div>
</div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>enable</span><span> </span><span>fail2ban</span><span> </span><span>--now</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 查看被禁 IP</span></div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>fail2ban-client</span><span> </span><span>status</span><span> </span><span>sshd</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section></section>
<section><h2>8. 故障排查<a href="#8-故障排查"><span>#</span></a></h2><section><h3>8.1 连接被拒绝（Connection refused）<a href="#81-连接被拒绝connection-refused"><span>#</span></a></h3><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>ssh: connect to host 123.456.78.90 port 2222: Connection refused</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>排查步骤：</strong></p><ol>
<li>检查 SSH 服务是否运行：<code>sudo systemctl status ssh</code></li>
<li>检查端口是否监听：<code>sudo ss -tlnp | grep ssh</code></li>
<li>检查配置文件语法：<code>sudo sshd -t</code></li>
<li>检查 ufw 是否放行：<code>sudo ufw status</code></li>
<li><strong>检查腾讯云安全组！</strong>（最常见原因）</li>
</ol></section><section><h3>8.2 权限拒绝（Permission denied）<a href="#82-权限拒绝permission-denied"><span>#</span></a></h3><div><figure><figcaption></figcaption><pre><code><div><div><div>1</div></div><div><span>Permission denied (publickey,password).</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>排查步骤：</strong></p><ol>
<li>用户名是否正确？（不是 root，是你创建的普通用户）</li>
<li>密码是否正确？</li>
<li>如果用了密钥：私钥路径是否正确？<code>ssh -v</code> 查看详细日志</li>
<li>服务器端 <code>~/.ssh/authorized_keys</code> 权限是否为 600？</li>
<li>服务器端 <code>~/.ssh</code> 目录权限是否为 700？</li>
</ol></section><section><h3>8.3 连接超时（Connection timed out）<a href="#83-连接超时connection-timed-out"><span>#</span></a></h3><ol>
<li>检查服务器是否开机</li>
<li>检查公网 IP 是否正确</li>
<li>检查安全组是否放行对应端口</li>
<li>检查本地网络是否允许出站到该端口（公司/学校网络可能限制）</li>
</ol></section><section><h3>8.4 被锁在服务器外（配置错误导致）<a href="#84-被锁在服务器外配置错误导致"><span>#</span></a></h3><p><strong>救急方法：</strong></p><ol>
<li>登录腾讯云控制台</li>
<li>找到你的服务器 → 点击「登录」→ 使用 VNC/控制台登录</li>
<li>用 root 密码登录（控制台不受 SSH 配置限制）</li>
<li>修复 <code>/etc/ssh/sshd_config</code></li>
<li><code>sudo systemctl restart ssh</code></li>
</ol><hr /></section></section>
<section><h2>9. Windows 安装 SSH 客户端<a href="#9-windows-安装-ssh-客户端"><span>#</span></a></h2><section><h3>9.1 Windows 10 / 11（推荐：内置 OpenSSH）<a href="#91-windows-10--11推荐内置-openssh"><span>#</span></a></h3><p>Windows 10（1809 及以上）和 Windows 11 已内置 OpenSSH 客户端，但默认可能未启用。</p><p><strong>方法一：图形界面安装</strong></p><ol>
<li>打开「设置」→「应用」→「可选功能」</li>
<li>点击「添加功能」</li>
<li>搜索「OpenSSH 客户端」</li>
<li>勾选并点击「安装」</li>
<li>等待安装完成</li>
</ol><p><strong>方法二：PowerShell 命令安装（管理员）</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 检查是否已安装</span></div></div><div><div><div>2</div></div><div><span>Get-WindowsCapability</span><span><span> </span><span>-</span><span>Online | </span></span><span>Where-Object</span><span><span> Name </span><span>-like</span><span> </span></span><span>'OpenSSH.Client*'</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 如果 State 显示为 NotPresent，则执行安装</span></div></div><div><div><div>5</div></div><div><span>Add-WindowsCapability</span><span><span> </span><span>-</span><span>Online </span><span>-</span><span>Name OpenSSH.Client~~~~</span></span><span>0.0</span><span>.</span><span>1.0</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 安装完成后验证</span></div></div><div><div><div>8</div></div><div><span><span>ssh </span><span>-</span><span>V</span></span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>验证安装成功：</strong></p><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span><span>ssh </span><span>-</span><span>V</span></span></div></div><div><div><div>2</div></div><div><span># 应输出类似：OpenSSH_for_Windows_8.1p1, LibreSSL 3.0.2</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>9.2 Windows 7 / 8 / 旧版 Windows 10<a href="#92-windows-7--8--旧版-windows-10"><span>#</span></a></h3><p>这些系统没有内置 OpenSSH，可使用以下替代方案：</p><p><strong>方案一：Git for Windows（推荐，自带 Git Bash 和 ssh）</strong></p><ol>
<li>访问 <a href="https://git-scm.com/download/win" target="_blank">https://git-scm.com/download/win</a></li>
<li>下载并安装 Git for Windows</li>
<li>安装过程中保持默认选项即可</li>
<li>安装完成后，右键桌面选择「Git Bash Here」</li>
<li>在 Git Bash 中输入：<code>ssh -V</code></li>
</ol><p><strong>方案二：PuTTY（经典 SSH 客户端）</strong></p><ol>
<li>访问 <a href="https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html" target="_blank">PuTTY 官网</a></li>
<li>下载 <code>putty-64bit-0.xx-installer.msi</code></li>
<li>安装后打开 PuTTY</li>
<li>在 Host Name 输入服务器 IP</li>
<li>在 Port 输入 2222（或你设置的端口）</li>
<li>Connection type 选择 SSH</li>
<li>点击 Open 连接</li>
</ol><p>PuTTY 使用密钥的方法：</p><ol>
<li>打开 PuTTYgen（随 PuTTY 安装）</li>
<li>点击 Generate 生成密钥对</li>
<li>保存私钥（.ppk 文件）</li>
<li>将公钥内容复制到服务器的 <code>~/.ssh/authorized_keys</code></li>
<li>在 PuTTY 中 → Connection → SSH → Auth → Private key file</li>
<li>选择你的 .ppk 私钥文件</li>
</ol><p><strong>方案三：MobaXterm（功能强大的终端工具）</strong></p><ol>
<li>访问 <a href="https://mobaxterm.mobatek.net/" target="_blank">MobaXterm 官网</a></li>
<li>下载免费版（Home Edition）</li>
<li>安装后打开，点击 Session → SSH</li>
<li>输入 Remote host 和 Port</li>
<li>点击 OK 连接</li>
</ol></section><section><h3>9.3 Windows 上使用 SSH 的注意事项<a href="#93-windows-上使用-ssh-的注意事项"><span>#</span></a></h3><ul>
<li>Windows 的 SSH 配置文件路径：<code>%USERPROFILE%\.ssh\config</code>（例如 <code>C:\Users\你的用户名\.ssh\config</code>）</li>
<li>首次连接时的 <code>known_hosts</code> 保存在：<code>%USERPROFILE%\.ssh\known_hosts</code></li>
<li>如果提示 “WARNING: UNPROTECTED PRIVATE KEY FILE”，需要右键私钥文件 → 属性 → 安全 → 高级 → 禁用继承 → 删除所有用户，然后只添加当前用户并赋予完全控制权限</li>
<li>PowerShell 中使用 ssh 时，参数与 Linux/macOS 完全一致</li>
</ul><hr /></section></section>
<section><h2>10. 删除用户<a href="#10-删除用户"><span>#</span></a></h2><section><h3>10.1 为什么需要删除用户？<a href="#101-为什么需要删除用户"><span>#</span></a></h3><ul>
<li>员工离职，需要清理其服务器账户</li>
<li>测试账号不再需要</li>
<li>发现异常账户，需要立即禁用或删除</li>
<li>系统维护，清理无用账户减少攻击面</li>
</ul></section><section><h3>10.2 查看系统中所有用户<a href="#102-查看系统中所有用户"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看所有普通用户（UID &gt;= 1000）</span></div></div><div><div><div>2</div></div><div><span>awk</span><span> </span><span>-F:</span><span> </span><span>'$3 &gt;= 1000 {print $1}'</span><span> </span><span>/etc/passwd</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看所有用户及其 UID、GID、家目录</span></div></div><div><div><div>5</div></div><div><span>cat</span><span> </span><span>/etc/passwd</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 查看当前在线用户</span></div></div><div><div><div>8</div></div><div><span>who</span></div></div><div><div><div>9</div></div><div><span>w</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span># 查看用户最近登录记录</span></div></div><div><div><div>12</div></div><div><span>last</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>10.3 删除用户（保留家目录）<a href="#103-删除用户保留家目录"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 使用 deluser（Debian/Ubuntu 推荐，更友好）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>deluser</span><span> </span><span>qtfy</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 或使用 userdel（通用命令）</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>userdel</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>效果：</strong> 删除用户账户和组，但保留 <code>/home/qtfy</code> 目录</p></section><section><h3>10.4 删除用户及其家目录<a href="#104-删除用户及其家目录"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># deluser 加 --remove-home 参数</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>deluser</span><span> </span><span>--remove-home</span><span> </span><span>qtfy</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># userdel 加 -r 参数</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>userdel</span><span> </span><span>-r</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure></div><p><strong>效果：</strong> 删除用户账户、组、家目录 <code>/home/qtfy</code>，以及邮件池</p></section><section><h3>10.5 彻底清理用户所有痕迹<a href="#105-彻底清理用户所有痕迹"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. 先强制终止该用户的所有进程</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>pkill</span><span> </span><span>-u</span><span> </span><span>qtfy</span></div></div><div><div><div>3</div></div><div><span>sudo</span><span> </span><span>killall</span><span> </span><span>-u</span><span> </span><span>qtfy</span></div></div><div><div><div>4</div></div><div>
</div></div><div><div><div>5</div></div><div><span># 2. 删除用户及其家目录</span></div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>deluser</span><span> </span><span>--remove-home</span><span> </span><span>qtfy</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 3. 手动检查并删除其他相关文件（如有）</span></div></div><div><div><div>9</div></div><div><span>sudo</span><span> </span><span>rm</span><span> </span><span>-rf</span><span> </span><span>/var/spool/mail/qtfy</span><span>       </span><span># 邮件池（deluser --remove-home 已处理）</span></div></div><div><div><div>10</div></div><div><span>sudo</span><span> </span><span>rm</span><span> </span><span>-rf</span><span> </span><span>/var/www/html/qtfy</span><span>         </span><span># 如有该用户的网站目录</span></div></div><div><div><div>11</div></div><div><span>sudo</span><span> </span><span>rm</span><span> </span><span>-rf</span><span> </span><span>/tmp/qtfy</span><span>*</span><span>                 </span><span># 临时文件</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 4. 从 sudo 权限中移除（如之前加入过）</span></div></div><div><div><div>14</div></div><div><span>sudo</span><span> </span><span>gpasswd</span><span> </span><span>-d</span><span> </span><span>qtfy</span><span> </span><span>sudo</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 5. 检查 crontab 任务</span></div></div><div><div><div>17</div></div><div><span>sudo</span><span> </span><span>crontab</span><span> </span><span>-u</span><span> </span><span>qtfy</span><span> </span><span>-l</span><span>    </span><span># 查看该用户的定时任务</span></div></div><div><div><div>18</div></div><div><span>sudo</span><span> </span><span>crontab</span><span> </span><span>-u</span><span> </span><span>qtfy</span><span> </span><span>-r</span><span>    </span><span># 删除该用户的定时任务</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>10.6 临时禁用用户（不解删除）<a href="#106-临时禁用用户不解删除"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 方法一：锁定密码（用户无法登录，但数据保留）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>passwd</span><span> </span><span>-l</span><span> </span><span>qtfy</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 解锁</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>passwd</span><span> </span><span>-u</span><span> </span><span>qtfy</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 方法二：设置账户过期日期为昨天（立即失效）</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>usermod</span><span> </span><span>--expiredate</span><span> </span><span>1</span><span> </span><span>qtfy</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 恢复账户</span></div></div><div><div><div>11</div></div><div><span>sudo</span><span> </span><span>usermod</span><span> </span><span>--expiredate</span><span> </span><span>""</span><span> </span><span>qtfy</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 方法三：将用户的 shell 改为 nologin（无法登录但数据保留）</span></div></div><div><div><div>14</div></div><div><span>sudo</span><span> </span><span>usermod</span><span> </span><span>-s</span><span> </span><span>/usr/sbin/nologin</span><span> </span><span>qtfy</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 恢复（假设原 shell 是 bash）</span></div></div><div><div><div>17</div></div><div><span>sudo</span><span> </span><span>usermod</span><span> </span><span>-s</span><span> </span><span>/bin/bash</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>10.7 删除用户时的注意事项<a href="#107-删除用户时的注意事项"><span>#</span></a></h3><div><div><div></div><div>WARNING</div></div><div><ul>
<li><strong>永远不要删除正在使用的用户！</strong> 确保该用户没有正在运行的进程：<code>ps -u qtfy</code>；确保该用户没有打开的文件：<code>lsof -u qtfy</code></li>
<li><strong>删除前备份重要数据！</strong> 如果用户家目录有重要文件，先备份：<code>sudo tar czvf /backup/qtfy_backup.tar.gz /home/qtfy</code></li>
<li><strong>检查该用户是否拥有系统服务！</strong> 某些服务可能以该用户运行，删除前需确认：<code>sudo systemctl list-units --type=service | grep qtfy</code></li>
<li><strong>不要删除系统内置用户！</strong> UID &lt; 1000 的用户通常是系统账户（如 root, www-data, mysql），除非明确知道用途，否则不要删除</li>
</ul></div></div><hr /></section></section>
<section><h2>11. 完整命令速查表<a href="#11-完整命令速查表"><span>#</span></a></h2><section><h3>服务器端<a href="#服务器端"><span>#</span></a></h3><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 检查 SSH 状态</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>status</span><span> </span><span>ssh</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 创建用户</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>adduser</span><span> </span><span>qtfy</span></div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>usermod</span><span> </span><span>-aG</span><span> </span><span>sudo</span><span> </span><span>qtfy</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 编辑 SSH 配置</span></div></div><div><div><div>9</div></div><div><span>sudo</span><span> </span><span>nano</span><span> </span><span>/etc/ssh/sshd_config</span></div></div><div><div><div>10</div></div><div>
</div></div><div><div><div>11</div></div><div><span># 关键配置项</span></div></div><div><div><div>12</div></div><div><span>Port</span><span> </span><span>2222</span></div></div><div><div><div>13</div></div><div><span>PermitRootLogin</span><span> </span><span>no</span></div></div><div><div><div>14</div></div><div><span>PasswordAuthentication</span><span> </span><span>yes</span></div></div><div><div><div>15</div></div><div><span>PubkeyAuthentication</span><span> </span><span>yes</span></div></div><div><div><div>16</div></div><div><span>AllowUsers</span><span> </span><span>qtfy</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span># 测试配置语法</span></div></div><div><div><div>19</div></div><div><span>sudo</span><span> </span><span>sshd</span><span> </span><span>-t</span></div></div><div><div><div>20</div></div><div>
</div></div><div><div><div>21</div></div><div><span># 重启 SSH</span></div></div><div><div><div>22</div></div><div><span>sudo</span><span> </span><span>systemctl</span><span> </span><span>restart</span><span> </span><span>ssh</span></div></div><div><div><div>23</div></div><div>
</div></div><div><div><div>24</div></div><div><span># 防火墙</span></div></div><div><div><div>25</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>2222/tcp</span></div></div><div><div><div>26</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>enable</span></div></div><div><div><div>27</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span></div></div><div><div><div>28</div></div><div>
</div></div><div><div><div>29</div></div><div><span># 查看登录日志</span></div></div><div><div><div>30</div></div><div><span>sudo</span><span> </span><span>tail</span><span> </span><span>-f</span><span> </span><span>/var/log/auth.log</span></div></div><div><div><div>31</div></div><div>
</div></div><div><div><div>32</div></div><div><span># 查看所有用户</span></div></div><div><div><div>33</div></div><div><span>awk</span><span> </span><span>-F:</span><span> </span><span>'$3 &gt;= 1000 {print $1}'</span><span> </span><span>/etc/passwd</span></div></div><div><div><div>34</div></div><div>
</div></div><div><div><div>35</div></div><div><span># 删除用户（保留家目录）</span></div></div><div><div><div>36</div></div><div><span>sudo</span><span> </span><span>deluser</span><span> </span><span>qtfy</span></div></div><div><div><div>37</div></div><div>
</div></div><div><div><div>38</div></div><div><span># 删除用户及家目录</span></div></div><div><div><div>39</div></div><div><span>sudo</span><span> </span><span>deluser</span><span> </span><span>--remove-home</span><span> </span><span>qtfy</span></div></div><div><div><div>40</div></div><div>
</div></div><div><div><div>41</div></div><div><span># 锁定用户</span></div></div><div><div><div>42</div></div><div><span>sudo</span><span> </span><span>passwd</span><span> </span><span>-l</span><span> </span><span>qtfy</span></div></div><div><div><div>43</div></div><div>
</div></div><div><div><div>44</div></div><div><span># 强制终止用户进程</span></div></div><div><div><div>45</div></div><div><span>sudo</span><span> </span><span>pkill</span><span> </span><span>-u</span><span> </span><span>qtfy</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div></section><section><h3>客户端<a href="#客户端"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 生成密钥</span></div></div><div><div><div>2</div></div><div><span>ssh-keygen</span><span> </span><span>-t</span><span> </span><span>ed25519</span><span> </span><span>-C</span><span> </span><span>"qtfy@example.com"</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 复制公钥到服务器</span></div></div><div><div><div>5</div></div><div><span>ssh-copy-id</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>qtfy@IP</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 连接</span></div></div><div><div><div>8</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>qtfy@IP</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 详细模式（排错）</span></div></div><div><div><div>11</div></div><div><span>ssh</span><span> </span><span>-v</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>qtfy@IP</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span># 使用配置文件后简化连接</span></div></div><div><div><div>14</div></div><div><span>ssh</span><span> </span><span>myserver</span></div></div></code></pre><div><div></div><div></div></div></figure></div></section><section><h3>Windows 安装 SSH<a href="#windows-安装-ssh"><span>#</span></a></h3><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 检查 OpenSSH 客户端是否安装</span></div></div><div><div><div>2</div></div><div><span>Get-WindowsCapability</span><span><span> </span><span>-</span><span>Online | </span></span><span>Where-Object</span><span><span> Name </span><span>-like</span><span> </span></span><span>'OpenSSH.Client*'</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 安装 OpenSSH 客户端（PowerShell 管理员）</span></div></div><div><div><div>5</div></div><div><span>Add-WindowsCapability</span><span><span> </span><span>-</span><span>Online </span><span>-</span><span>Name OpenSSH.Client~~~~</span></span><span>0.0</span><span>.</span><span>1.0</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 验证</span></div></div><div><div><div>8</div></div><div><span><span>ssh </span><span>-</span><span>V</span></span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /><blockquote><p><strong>文档版本：</strong> 2026-07-30<br />
<strong>适用系统：</strong> Debian 11+ / Ubuntu 20.04+<br />
<strong>适用平台：</strong> 腾讯云 CVM / 任何支持 SSH 的 Linux 服务器</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/linux/SSH完整配置指南.txt">点击下载 TXT 版本</a></p></div></div><hr /></section></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/tmux-cheatsheet/</id>
      <title type="text">tmux 命令速查表</title>
      <published>2026-07-30T00:00:00.000Z</published>
      <updated>2026-08-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/tmux-cheatsheet/"/>
      <summary type="text">tmux 终端复用器完整速查表，涵盖安装、会话管理、窗口与面板操作、复制模式、配置文件及典型工作流。</summary>
      <content type="html"><![CDATA[<blockquote><p>tmux 是一款终端复用器，让你在一个终端窗口里运行多个会话、窗口和面板，SSH 断开后任务仍在后台运行。</p></blockquote>
<hr />
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%AE%89%E8%A3%85">安装</a></li>
<li><a href="#2-%E4%BC%9A%E8%AF%9D%E7%AE%A1%E7%90%86">会话管理</a></li>
<li><a href="#3-%E5%BF%AB%E6%8D%B7%E9%94%AE">快捷键</a></li>
<li><a href="#4-%E5%91%BD%E4%BB%A4%E6%A8%A1%E5%BC%8F">命令模式</a></li>
<li><a href="#5-%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6">配置文件</a></li>
<li><a href="#6-%E5%85%B8%E5%9E%8B%E5%B7%A5%E4%BD%9C%E6%B5%81%E7%A8%8B">典型工作流程</a></li>
<li><a href="#7-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98">常见问题</a></li>
</ol><hr /></section>
<section><h2>1. 安装<a href="#1-安装"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># Debian/Ubuntu</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>apt</span><span> </span><span>install</span><span> </span><span>tmux</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># CentOS/RHEL</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>yum</span><span> </span><span>install</span><span> </span><span>tmux</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># macOS</span></div></div><div><div><div>8</div></div><div><span>brew</span><span> </span><span>install</span><span> </span><span>tmux</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>2. 会话管理<a href="#2-会话管理"><span>#</span></a></h2>

<table><thead><tr><th>命令</th><th>作用</th></tr></thead><tbody><tr><td><code>tmux</code></td><td>新建匿名会话</td></tr><tr><td><code>tmux new -s name</code></td><td>新建命名会话</td></tr><tr><td><code>tmux new -s name -d</code></td><td>后台新建会话</td></tr><tr><td><code>tmux ls</code></td><td>列出所有会话</td></tr><tr><td><code>tmux attach</code></td><td>恢复最近会话</td></tr><tr><td><code>tmux attach -t name</code></td><td>恢复指定会话</td></tr><tr><td><code>tmux a -t name</code></td><td>attach 简写</td></tr><tr><td><code>tmux switch -t name</code></td><td>切换到另一个会话</td></tr><tr><td><code>tmux rename-session -t old new</code></td><td>重命名会话</td></tr><tr><td><code>tmux kill-session -t name</code></td><td>关闭指定会话</td></tr><tr><td><code>tmux kill-server</code></td><td>关闭所有会话</td></tr><tr><td><code>exit</code> 或 <code>Ctrl+d</code></td><td>关闭当前窗口，最后一个窗口关闭时会话结束</td></tr></tbody></table><hr /></section>
<section><h2>3. 快捷键<a href="#3-快捷键"><span>#</span></a></h2><blockquote><p>先按 <code>Ctrl+b</code>，松开后按下面键。</p></blockquote><section><h3>会话操作<a href="#会话操作"><span>#</span></a></h3>

<table><thead><tr><th>快捷键</th><th>作用</th></tr></thead><tbody><tr><td><code>Ctrl+b d</code></td><td>detach，退出会话但保持运行</td></tr><tr><td><code>Ctrl+b s</code></td><td>列出所有会话，用方向键选择切换</td></tr><tr><td><code>Ctrl+b $</code></td><td>重命名当前会话</td></tr><tr><td><code>Ctrl+b (</code></td><td>切换到上一个会话</td></tr><tr><td><code>Ctrl+b )</code></td><td>切换到下一个会话</td></tr></tbody></table></section><section><h3>窗口操作<a href="#窗口操作"><span>#</span></a></h3>

<table><thead><tr><th>快捷键</th><th>作用</th></tr></thead><tbody><tr><td><code>Ctrl+b c</code></td><td>新建窗口</td></tr><tr><td><code>Ctrl+b ,</code></td><td>重命名当前窗口</td></tr><tr><td><code>Ctrl+b &amp;</code></td><td>关闭当前窗口</td></tr><tr><td><code>Ctrl+b n</code></td><td>下一个窗口</td></tr><tr><td><code>Ctrl+b p</code></td><td>上一个窗口</td></tr><tr><td><code>Ctrl+b 0~9</code></td><td>切换到指定编号窗口</td></tr><tr><td><code>Ctrl+b w</code></td><td>列出所有窗口，用方向键选择</td></tr><tr><td><code>Ctrl+b f</code></td><td>按名称查找窗口</td></tr><tr><td><code>Ctrl+b .</code></td><td>移动当前窗口到指定编号</td></tr></tbody></table></section><section><h3>面板操作（分屏）<a href="#面板操作分屏"><span>#</span></a></h3>

<table><thead><tr><th>快捷键</th><th>作用</th></tr></thead><tbody><tr><td><code>Ctrl+b %</code></td><td>左右垂直分屏</td></tr><tr><td><code>Ctrl+b "</code></td><td>上下水平分屏</td></tr><tr><td><code>Ctrl+b 方向键</code></td><td>切换到相邻面板</td></tr><tr><td><code>Ctrl+b o</code></td><td>切换到下一个面板</td></tr><tr><td><code>Ctrl+b ;</code></td><td>切换到上一个面板</td></tr><tr><td><code>Ctrl+b x</code></td><td>关闭当前面板</td></tr><tr><td><code>Ctrl+b z</code></td><td>最大化/还原当前面板</td></tr><tr><td><code>Ctrl+b !</code></td><td>将当前面板拆成独立窗口</td></tr><tr><td><code>Ctrl+b 空格</code></td><td>切换面板布局</td></tr><tr><td><code>Ctrl+b Ctrl+方向键</code></td><td>调整面板大小</td></tr><tr><td><code>Ctrl+b Alt+方向键</code></td><td>以 5 格为单位调整面板大小</td></tr><tr><td><code>Ctrl+b {</code></td><td>当前面板与上一个交换位置</td></tr><tr><td><code>Ctrl+b }</code></td><td>当前面板与下一个交换位置</td></tr><tr><td><code>Ctrl+b q</code></td><td>显示面板编号，按数字快速跳转</td></tr></tbody></table></section><section><h3>复制模式（翻页、复制文本）<a href="#复制模式翻页复制文本"><span>#</span></a></h3>

<table><thead><tr><th>快捷键</th><th>作用</th></tr></thead><tbody><tr><td><code>Ctrl+b [</code></td><td>进入复制模式（可翻页查看历史输出）</td></tr><tr><td><code>空格</code></td><td>开始选择</td></tr><tr><td><code>Enter</code></td><td>复制选中内容</td></tr><tr><td><code>Ctrl+b ]</code></td><td>粘贴</td></tr><tr><td><code>q</code></td><td>退出复制模式</td></tr><tr><td><code>/</code></td><td>向下搜索</td></tr><tr><td><code>?</code></td><td>向上搜索</td></tr><tr><td><code>n</code></td><td>下一个搜索结果</td></tr><tr><td><code>N</code></td><td>上一个搜索结果</td></tr><tr><td><code>g</code></td><td>跳到第一行</td></tr><tr><td><code>G</code></td><td>跳到最后一行</td></tr></tbody></table></section><section><h3>其他常用<a href="#其他常用"><span>#</span></a></h3>

<table><thead><tr><th>快捷键</th><th>作用</th></tr></thead><tbody><tr><td><code>Ctrl+b ?</code></td><td>显示所有快捷键帮助</td></tr><tr><td><code>Ctrl+b t</code></td><td>显示时间</td></tr><tr><td><code>Ctrl+b :</code></td><td>进入命令模式（可输入 tmux 命令）</td></tr><tr><td><code>Ctrl+b r</code></td><td>重载 tmux 配置</td></tr><tr><td><code>Ctrl+b ~</code></td><td>查看历史消息</td></tr></tbody></table><hr /></section></section>
<section><h2>4. 命令模式<a href="#4-命令模式"><span>#</span></a></h2><p>按 <code>Ctrl+b :</code> 进入命令模式。</p>

<table><thead><tr><th>命令</th><th>作用</th></tr></thead><tbody><tr><td><code>new -s name</code></td><td>新建会话</td></tr><tr><td><code>kill-session</code></td><td>关闭当前会话</td></tr><tr><td><code>set -g mouse on</code></td><td>开启鼠标支持</td></tr><tr><td><code>set -g mouse off</code></td><td>关闭鼠标支持</td></tr><tr><td><code>resize-pane -L 10</code></td><td>左侧面板扩大 10 格</td></tr><tr><td><code>resize-pane -R 10</code></td><td>右侧面板扩大 10 格</td></tr><tr><td><code>resize-pane -U 5</code></td><td>上面面板扩大 5 格</td></tr><tr><td><code>resize-pane -D 5</code></td><td>下面面板扩大 5 格</td></tr></tbody></table><hr /></section>
<section><h2>5. 配置文件<a href="#5-配置文件"><span>#</span></a></h2><p>配置文件路径：<code>~/.tmux.conf</code></p><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 重新加载配置快捷键</span></div></div><div><div><div>2</div></div><div><span>bind</span><span> </span><span>r</span><span> </span><span>source-file</span><span> </span><span>~/.tmux.conf</span><span> </span><span>\;</span><span> </span><span>display</span><span> </span><span>"Config reloaded!"</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 开启鼠标支持</span></div></div><div><div><div>5</div></div><div><span>set</span><span> </span><span>-g</span><span> </span><span>mouse</span><span> </span><span>on</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 修改前缀键为 Ctrl+a（可选，适合习惯 screen 的用户）</span></div></div><div><div><div>8</div></div><div><span># unbind C-b</span></div></div><div><div><div>9</div></div><div><span># set -g prefix C-a</span></div></div><div><div><div>10</div></div><div><span># bind C-a send-prefix</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span># 窗口编号从 1 开始</span></div></div><div><div><div>13</div></div><div><span>set</span><span> </span><span>-g</span><span> </span><span>base-index</span><span> </span><span>1</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span># 面板编号从 1 开始</span></div></div><div><div><div>16</div></div><div><span>setw</span><span> </span><span>-g</span><span> </span><span>pane-base-index</span><span> </span><span>1</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span># 状态栏样式</span></div></div><div><div><div>19</div></div><div><span>set</span><span> </span><span>-g</span><span> </span><span>status-style</span><span> </span><span>bg=black,fg=white</span></div></div><div><div><div>20</div></div><div><span>set</span><span> </span><span>-g</span><span> </span><span>window-status-current-style</span><span> </span><span>bg=blue,fg=white</span></div></div><div><div><div>21</div></div><div>
</div></div><div><div><div>22</div></div><div><span># 历史行数</span></div></div><div><div><div>23</div></div><div><span>set</span><span> </span><span>-g</span><span> </span><span>history-limit</span><span> </span><span>10000</span></div></div><div><div><div>24</div></div><div>
</div></div><div><div><div>25</div></div><div><span># 自动重命名窗口</span></div></div><div><div><div>26</div></div><div><span>setw</span><span> </span><span>-g</span><span> </span><span>automatic-rename</span><span> </span><span>on</span></div></div><div><div><div>27</div></div><div>
</div></div><div><div><div>28</div></div><div><span># 窗口活动通知</span></div></div><div><div><div>29</div></div><div><span>setw</span><span> </span><span>-g</span><span> </span><span>monitor-activity</span><span> </span><span>on</span></div></div><div><div><div>30</div></div><div><span>set</span><span> </span><span>-g</span><span> </span><span>visual-activity</span><span> </span><span>on</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>6. 典型工作流程<a href="#6-典型工作流程"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. SSH 连上服务器</span></div></div><div><div><div>2</div></div><div><span>ssh</span><span> </span><span>-p</span><span> </span><span>2222</span><span> </span><span>user@服务器IP</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 2. 新建 tmux 会话跑任务</span></div></div><div><div><div>5</div></div><div><span>tmux</span><span> </span><span>new</span><span> </span><span>-s</span><span> </span><span>work</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 3. 在 tmux 里跑长时间任务</span></div></div><div><div><div>8</div></div><div><span>python</span><span> </span><span>train.py</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 4. 按 Ctrl+b 然后 d，断开（任务继续跑）</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span># 5. 之后重连 SSH，恢复会话</span></div></div><div><div><div>13</div></div><div><span>tmux</span><span> </span><span>attach</span><span> </span><span>-t</span><span> </span><span>work</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span># 6. 开多个窗口管理不同任务</span></div></div><div><div><div>16</div></div><div><span>Ctrl+b</span><span> </span><span>c</span><span>          </span><span># 新建窗口跑日志</span></div></div><div><div><div>17</div></div><div><span>Ctrl+b</span><span> </span><span>c</span><span>          </span><span># 再新建窗口编辑配置</span></div></div><div><div><div>18</div></div><div><span>Ctrl+b</span><span> </span><span>n</span><span>          </span><span># 切换窗口</span></div></div><div><div><div>19</div></div><div>
</div></div><div><div><div>20</div></div><div><span># 7. 分屏同时看多个输出</span></div></div><div><div><div>21</div></div><div><span>Ctrl+b</span><span> </span><span>%</span><span>          </span><span># 左右分屏</span></div></div><div><div><div>22</div></div><div><span>Ctrl+b</span><span> </span><span>"          # 上下分屏</span></div></div><div><div><div>23</div></div><div>
</div></div><div><div><div>24</div></div><div><span># 8. 做完事关闭会话</span></div></div><div><div><div>25</div></div><div><span>tmux kill-session -t work</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>7. 常见问题<a href="#7-常见问题"><span>#</span></a></h2>

<table><thead><tr><th>问题</th><th>解决</th></tr></thead><tbody><tr><td>鼠标滚轮不能翻页</td><td>按 <code>Ctrl+b [</code> 进入复制模式，或开启 <code>set -g mouse on</code></td></tr><tr><td>复制后粘贴乱码</td><td>按住 Shift 再鼠标选中复制</td></tr><tr><td>颜色显示不对</td><td>终端设置 <code>TERM=xterm-256color</code></td></tr><tr><td>中文显示乱码</td><td>终端编码设 UTF-8，locale 设 <code>zh_CN.UTF-8</code></td></tr></tbody></table><hr /><blockquote><p><strong>文档版本：</strong> 2026-07-30</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/linux/tmux命令速查表.txt">点击下载 TXT 版本</a></p></div></div><hr /></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/ufw-firewall-manual/</id>
      <title type="text">UFW 防火墙使用手册</title>
      <published>2026-07-30T00:00:00.000Z</published>
      <updated>2026-08-09T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/ufw-firewall-manual/"/>
      <summary type="text">UFW（Uncomplicated Firewall）完整使用手册，涵盖状态查看、端口管理、IP 白名单/黑名单、速率限制、日志管理及完整配置示例。</summary>
      <content type="html"><![CDATA[<blockquote><p>UFW（Uncomplicated Firewall）是 Ubuntu/Debian 系统自带的简化版 iptables 防火墙管理工具，易用且功能强大。</p></blockquote>
<hr />
<section><h2>目录<a href="#目录"><span>#</span></a></h2><ol>
<li><a href="#1-%E5%9F%BA%E6%9C%AC%E7%8A%B6%E6%80%81%E6%9F%A5%E7%9C%8B">基本状态查看</a></li>
<li><a href="#2-%E5%90%AF%E7%94%A8%E4%B8%8E%E7%A6%81%E7%94%A8">启用与禁用</a></li>
<li><a href="#3-%E7%AB%AF%E5%8F%A3%E7%AE%A1%E7%90%86">端口管理</a></li>
<li><a href="#4-ip-%E7%99%BD%E5%90%8D%E5%8D%95%E4%B8%8E%E9%BB%91%E5%90%8D%E5%8D%95">IP 白名单与黑名单</a></li>
<li><a href="#5-%E9%BB%98%E8%AE%A4%E7%AD%96%E7%95%A5">默认策略</a></li>
<li><a href="#6-%E5%BA%94%E7%94%A8%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6">应用配置文件</a></li>
<li><a href="#7-%E6%8E%A5%E5%8F%A3%E7%BA%A7%E5%88%AB%E7%9A%84%E8%A7%84%E5%88%99">接口级别的规则</a></li>
<li><a href="#8-%E6%97%A5%E5%BF%97%E7%AE%A1%E7%90%86">日志管理</a></li>
<li><a href="#9-%E9%80%9F%E7%8E%87%E9%99%90%E5%88%B6">速率限制</a></li>
<li><a href="#10-%E8%A7%84%E5%88%99%E4%BC%98%E5%85%88%E7%BA%A7%E4%B8%8E%E6%8F%92%E5%85%A5">规则优先级与插入</a></li>
<li><a href="#11-%E5%AE%8C%E6%95%B4%E9%85%8D%E7%BD%AE%E7%A4%BA%E4%BE%8B">完整配置示例</a></li>
<li><a href="#12-%E5%B8%B8%E8%A7%81%E9%97%AE%E9%A2%98%E6%8E%92%E6%9F%A5">常见问题排查</a></li>
</ol><hr /></section>
<section><h2>1. 基本状态查看<a href="#1-基本状态查看"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看防火墙状态（是否启用、已开放端口）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看详细状态（含编号、动作、来源等）</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span><span> </span><span>verbose</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 查看带编号的规则列表（方便删除指定规则）</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span><span> </span><span>numbered</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 查看防火墙版本</span></div></div><div><div><div>11</div></div><div><span>ufw</span><span> </span><span>--version</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>2. 启用与禁用<a href="#2-启用与禁用"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 启用防火墙（首次启用会提示可能断开 SSH，确认已放行 22 端口再执行）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>enable</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 禁用防火墙（完全关闭，所有规则失效但保留）</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>disable</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 重置防火墙（清空所有规则并禁用，谨慎使用）</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>reset</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>WARNING</div></div><div><p><code>sudo ufw reset</code> 会<strong>清空所有规则并禁用防火墙</strong>，执行前请确认你还有其他方式可以连接服务器（如 VNC/控制台）。</p></div></div><hr /></section>
<section><h2>3. 端口管理<a href="#3-端口管理"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 开放指定端口（TCP 默认）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>22</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>80</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>443</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>8080</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 开放指定端口并指定协议</span></div></div><div><div><div>11</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>22/tcp</span></div></div><div><div><div>12</div></div><div>
</div></div><div><div><div>13</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>53/udp</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span># 开放端口范围</span></div></div><div><div><div>16</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>1000:2000/tcp</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>1000:2000/udp</span></div></div><div><div><div>19</div></div><div>
</div></div><div><div><div>20</div></div><div><span># 关闭（拒绝）指定端口</span></div></div><div><div><div>21</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>deny</span><span> </span><span>3306</span></div></div><div><div><div>22</div></div><div>
</div></div><div><div><div>23</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>deny</span><span> </span><span>6379/tcp</span></div></div><div><div><div>24</div></div><div>
</div></div><div><div><div>25</div></div><div><span># 删除某条开放端口的规则</span></div></div><div><div><div>26</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>delete</span><span> </span><span>allow</span><span> </span><span>8080</span></div></div><div><div><div>27</div></div><div>
</div></div><div><div><div>28</div></div><div><span># 通过编号删除规则（先用 status numbered 查看编号）</span></div></div><div><div><div>29</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span><span> </span><span>numbered</span></div></div><div><div><div>30</div></div><div>
</div></div><div><div><div>31</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>delete</span><span> </span><span>3</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>4. IP 白名单与黑名单<a href="#4-ip-白名单与黑名单"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 允许单个 IP 访问所有端口（全局白名单）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>192.168.1.100</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 允许单个 IP 访问指定端口</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>192.168.1.100</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>22</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>192.168.1.100</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>3306</span></div></div><div><div><div>8</div></div><div>
</div></div><div><div><div>9</div></div><div><span># 允许 IP 段访问（CIDR 格式）</span></div></div><div><div><div>10</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>192.168.1.0/24</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>10.0.0.0/8</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>22</span></div></div><div><div><div>13</div></div><div>
</div></div><div><div><div>14</div></div><div><span># 允许特定 IP 和端口组合</span></div></div><div><div><div>15</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>203.0.113.0/24</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>8080</span><span> </span><span>proto</span><span> </span><span>tcp</span></div></div><div><div><div>16</div></div><div>
</div></div><div><div><div>17</div></div><div><span># 拒绝单个 IP（黑名单）</span></div></div><div><div><div>18</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>deny</span><span> </span><span>from</span><span> </span><span>192.168.1.200</span></div></div><div><div><div>19</div></div><div>
</div></div><div><div><div>20</div></div><div><span># 拒绝 IP 段</span></div></div><div><div><div>21</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>deny</span><span> </span><span>from</span><span> </span><span>10.10.10.0/24</span></div></div><div><div><div>22</div></div><div>
</div></div><div><div><div>23</div></div><div><span># 删除某条 IP 规则</span></div></div><div><div><div>24</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>delete</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>192.168.1.100</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>5. 默认策略<a href="#5-默认策略"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 默认拒绝所有传入连接（推荐，安全模式）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>deny</span><span> </span><span>incoming</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 默认允许所有传出连接（推荐）</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>allow</span><span> </span><span>outgoing</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 默认允许所有传入（不推荐，除非在内网测试）</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>allow</span><span> </span><span>incoming</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 默认拒绝所有传出（极端安全，可能断网）</span></div></div><div><div><div>11</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>deny</span><span> </span><span>outgoing</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>6. 应用配置文件<a href="#6-应用配置文件"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 查看系统预置的应用配置列表</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>app</span><span> </span><span>list</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 查看某个应用具体会开放哪些端口</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>app</span><span> </span><span>info</span><span> </span><span>'Nginx Full'</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>app</span><span> </span><span>info</span><span> </span><span>'OpenSSH'</span></div></div><div><div><div>8</div></div><div>
</div></div><div><div><div>9</div></div><div><span># 通过应用名放行（比记端口号更方便）</span></div></div><div><div><div>10</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>'OpenSSH'</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>'Nginx Full'</span></div></div><div><div><div>13</div></div><div>
</div></div><div><div><div>14</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>'Apache'</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>'MySQL'</span></div></div><div><div><div>17</div></div><div>
</div></div><div><div><div>18</div></div><div><span># 删除应用规则</span></div></div><div><div><div>19</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>delete</span><span> </span><span>allow</span><span> </span><span>'Nginx Full'</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>7. 接口级别的规则<a href="#7-接口级别的规则"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 仅允许从指定网卡进入的流量</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>in</span><span> </span><span>on</span><span> </span><span>eth0</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>80</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>in</span><span> </span><span>on</span><span> </span><span>eth0</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>443</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span># 拒绝某网卡的所有传入</span></div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>deny</span><span> </span><span>in</span><span> </span><span>on</span><span> </span><span>eth1</span></div></div><div><div><div>8</div></div><div>
</div></div><div><div><div>9</div></div><div><span># 查看网卡名称</span></div></div><div><div><div>10</div></div><div><span>ip</span><span> </span><span>addr</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>8. 日志管理<a href="#8-日志管理"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 启用日志（记录被拦截/放行的连接）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>logging</span><span> </span><span>on</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 禁用日志</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>logging</span><span> </span><span>off</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 设置日志级别</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>logging</span><span> </span><span>low</span><span>      </span><span># 低：只记录被拦截的</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>logging</span><span> </span><span>medium</span><span>   </span><span># 中：记录被拦截和放行的</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>logging</span><span> </span><span>high</span><span>     </span><span># 高：记录所有，包括速率限制</span></div></div><div><div><div>13</div></div><div>
</div></div><div><div><div>14</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>logging</span><span> </span><span>full</span><span>     </span><span># 完整：记录所有包</span></div></div><div><div><div>15</div></div><div>
</div></div><div><div><div>16</div></div><div><span># 查看 UFW 日志</span></div></div><div><div><div>17</div></div><div><span>sudo</span><span> </span><span>tail</span><span> </span><span>-f</span><span> </span><span>/var/log/ufw.log</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>9. 速率限制<a href="#9-速率限制"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 限制 SSH 连接速率（30 秒内超过 6 次连接会被临时封禁）</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>limit</span><span> </span><span>22/tcp</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>limit</span><span> </span><span>ssh</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span># 限制其他端口速率</span></div></div><div><div><div>7</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>limit</span><span> </span><span>8080/tcp</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>10. 规则优先级与插入<a href="#10-规则优先级与插入"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># UFW 规则按添加顺序匹配，先匹配的先执行</span></div></div><div><div><div>2</div></div><div><span># 建议顺序：白名单 &gt; 正常端口 &gt; 拒绝所有</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 在指定位置插入规则（例如在规则 #1 之前插入）</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>insert</span><span> </span><span>1</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>192.168.1.100</span></div></div></code></pre><div><div></div><div></div></div></figure></div><hr /></section>
<section><h2>11. 完整配置示例（Web 服务器场景）<a href="#11-完整配置示例web-服务器场景"><span>#</span></a></h2><div><div><div><figure><figcaption><span></span><span>Terminal window</span><span>展开</span><span>收起</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 1. 重置并设置默认策略</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>reset</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>deny</span><span> </span><span>incoming</span></div></div><div><div><div>5</div></div><div>
</div></div><div><div><div>6</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>default</span><span> </span><span>allow</span><span> </span><span>outgoing</span></div></div><div><div><div>7</div></div><div>
</div></div><div><div><div>8</div></div><div><span># 2. 先放行 SSH（防止把自己锁在外面）</span></div></div><div><div><div>9</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>22/tcp</span></div></div><div><div><div>10</div></div><div><span># 或 sudo ufw allow 'OpenSSH'</span></div></div><div><div><div>11</div></div><div>
</div></div><div><div><div>12</div></div><div><span># 3. 放行 Web 端口</span></div></div><div><div><div>13</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>80/tcp</span></div></div><div><div><div>14</div></div><div>
</div></div><div><div><div>15</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>443/tcp</span></div></div><div><div><div>16</div></div><div>
</div></div><div><div><div>17</div></div><div><span># 4. 放行 1Panel 端口（如果需要）</span></div></div><div><div><div>18</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>42544/tcp</span></div></div><div><div><div>19</div></div><div>
</div></div><div><div><div>20</div></div><div><span># 5. 添加管理员 IP 白名单（可选）</span></div></div><div><div><div>21</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>allow</span><span> </span><span>from</span><span> </span><span>203.0.113.50</span><span> </span><span>to</span><span> </span><span>any</span><span> </span><span>port</span><span> </span><span>22</span></div></div><div><div><div>22</div></div><div>
</div></div><div><div><div>23</div></div><div><span># 6. 启用防火墙</span></div></div><div><div><div>24</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>enable</span></div></div><div><div><div>25</div></div><div>
</div></div><div><div><div>26</div></div><div><span># 7. 查看最终规则</span></div></div><div><div><div>27</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>status</span><span> </span><span>verbose</span></div></div></code></pre><div><div></div><div></div></div></figure><div></div></div><span>展开</span><span>收起</span></div></div><hr /></section>
<section><h2>12. 常见问题排查<a href="#12-常见问题排查"><span>#</span></a></h2><div><figure><figcaption><span></span><span>Terminal window</span></figcaption><pre><code><div><div><div>1</div></div><div><span># 规则不生效？</span></div></div><div><div><div>2</div></div><div><span>sudo</span><span> </span><span>ufw</span><span> </span><span>reload</span></div></div><div><div><div>3</div></div><div>
</div></div><div><div><div>4</div></div><div><span># 检查 iptables 底层规则（UFW 的底层）</span></div></div><div><div><div>5</div></div><div><span>sudo</span><span> </span><span>iptables</span><span> </span><span>-L</span><span> </span><span>-n</span><span> </span><span>-v</span><span> | </span><span>grep</span><span> </span><span>ufw</span></div></div><div><div><div>6</div></div><div>
</div></div><div><div><div>7</div></div><div><span># 查看某端口是否被监听</span></div></div><div><div><div>8</div></div><div><span>sudo</span><span> </span><span>ss</span><span> </span><span>-tunlp</span><span> | </span><span>grep</span><span> </span><span>:80</span></div></div><div><div><div>9</div></div><div>
</div></div><div><div><div>10</div></div><div><span># 测试端口连通性（从其他机器）</span></div></div><div><div><div>11</div></div><div><span>nc</span><span> </span><span>-zv</span><span> </span><span>你的IP</span><span> </span><span>80</span></div></div></code></pre><div><div></div><div></div></div></figure></div><div><div><div></div><div>CAUTION</div></div><div><p>如果启用 UFW 后 SSH 连不上，在服务器控制台/VNC 执行 <code>sudo ufw disable</code> 或 <code>sudo ufw allow 22/tcp</code> 恢复。</p></div></div><hr /><blockquote><p><strong>文档版本：</strong> 2026-07-30</p></blockquote><hr /><div><div><div></div><div>本地阅读版下载</div></div><div><p><a href="/downloads/linux/UFW防火墙使用手册.txt">点击下载 TXT 版本</a></p></div></div><hr /></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/server-recommendation/</id>
      <title type="text">2026年云服务器选购指南：雨云与联维云深度对比评测</title>
      <published>2026-07-27T00:00:00.000Z</published>
      <updated>2026-07-27T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/server-recommendation/"/>
      <summary type="text">本文深入对比雨云和联维云两家国产云服务器商，从产品线、性能、价格、适用场景等维度进行全面分析，助你找到最适合自己的云服务器方案。</summary>
      <content type="html"><![CDATA[<section><h1>2026年云服务器选购指南：雨云与联维云深度对比评测<a href="#2026年云服务器选购指南雨云与联维云深度对比评测"><span>#</span></a></h1><p>对于个人站长、开发者以及初创团队来说，选择一台合适的云服务器往往是项目起步的第一步。面对市场上琳琅满目的云服务商，如何在性价比、稳定性和易用性之间找到平衡，是许多人头疼的问题。今天，我想和大家聊聊两家在国产云服务领域颇具特色的厂商——<strong>雨云（RainYun）<strong>和</strong>联维云（Lecway）</strong>。它们定位不同、各有所长，或许能为你提供一份清晰的选购参考。</p><hr /><section><h2>🌧️ 雨云：高性价比的”玩家之选”<a href="#️-雨云高性价比的玩家之选"><span>#</span></a></h2><p>雨云成立于2018年，是一家专注于提供高性价比云服务的国产厂商。经过七年发展，它已积累了超过30,000个运行网站，凭借亲民的价格和灵活的产品设计，在个人站长、学生党和游戏服主群体中拥有相当不错的口碑。</p><section><h3>核心亮点<a href="#核心亮点"><span>#</span></a></h3><p><strong>1. 自研管理面板，上手零门槛</strong></p><p>雨云最大的特色之一是其精心自研的CMS管理后台。不同于大厂那种功能繁杂、令人眼花缭乱的控制台，雨云的后台界面清爽直观，重装系统、数据备份、在线监控等操作基本”点几下就搞定”。对于刚接触服务器的新手来说，这种”开箱即用”的体验非常友好。</p><p><strong>2. 产品线丰富，覆盖多元场景</strong></p><p>雨云的产品矩阵相当完整，主要包括：</p>

<table><thead><tr><th>产品类型</th><th>适用场景</th><th>核心特点</th></tr></thead><tbody><tr><td><strong>云服务器（RCS）</strong></td><td>网站搭建、应用部署、开发测试</td><td>多机房可选，支持宝塔/1Panel一键安装</td></tr><tr><td><strong>游戏云（RGS）</strong></td><td>Minecraft、泰拉瑞亚等游戏开服</td><td>高主频CPU（9950X/14900K），MCSM面板一键开服</td></tr><tr><td><strong>虚拟主机</strong></td><td>轻量级网站、博客</td><td>成本低，免运维</td></tr><tr><td><strong>裸金属物理机</strong></td><td>高性能计算、大数据处理</td><td>独享物理资源</td></tr><tr><td><strong>对象存储 + CDN</strong></td><td>静态资源加速、文件存储</td><td>配套云产品，性价比高</td></tr></tbody></table><p><strong>3. 灵活计费，试错成本低</strong></p><p>雨云支持按天计费和动态计费两种模式。按天计费适合短期试用，动态计费则根据实际CPU消耗结算，对于负载波动大的应用能显著节省开支。此外，雨云还提供<strong>7天无理由退订</strong>政策，每位用户有3次机会，大大降低了试错成本。</p><p><strong>4. 机房覆盖广，线路优化到位</strong></p><p>雨云在国内外部署了多个数据中心：</p><ul>
<li><strong>国内节点</strong>：浙江宁波（大带宽）、江苏宿迁（150G高防）、湖北十堰（高防）、广东深圳、重庆等</li>
<li><strong>海外节点</strong>：美国洛杉矶（CN2 GIA/AS9929三网直连）、中国香港（BGP多线）、日本东京（低延迟）</li>
</ul><p>其中，美国洛杉矶的AS9929精品线路和香港的三网直连线路，对于需要免备案或面向海外用户的业务来说，速度和稳定性都相当出色。</p></section><section><h3>价格与优惠<a href="#价格与优惠"><span>#</span></a></h3><p>雨云的价格在行业内属于非常有竞争力的水平。以热门的云服务器为例：</p>

<table><thead><tr><th>配置</th><th>CPU</th><th>内存</th><th>硬盘</th><th>带宽</th><th>月付价格</th></tr></thead><tbody><tr><td>入门版</td><td>1核</td><td>1G</td><td>30G SSD</td><td>10M/15M</td><td>20元/月起</td></tr><tr><td>标准版</td><td>2核</td><td>2G</td><td>30G SSD</td><td>15M/25M</td><td>28元/月起</td></tr><tr><td>中配版</td><td>2核</td><td>4G</td><td>30G SSD</td><td>20M/30M</td><td>38元/月起</td></tr><tr><td>进阶版</td><td>4核</td><td>4G</td><td>30G SSD</td><td>25M/35M</td><td>52元/月起</td></tr></tbody></table><p><strong>长期折扣</strong>方面，雨云提供季付9折、半年付8折、年付7折的周期优惠，可与优惠券叠加使用。</p><section><h4>💰 专属优惠码<a href="#-专属优惠码"><span>#</span></a></h4><p>如果你打算尝试雨云，别忘了使用以下优惠码获取额外折扣：</p><blockquote><p><strong>优惠码：<code>NjQ5Mzg2</code></strong></p><p>使用方法：在雨云官网注册账号后，进入「积分中心」→「兑换优惠券」页面，输入上述优惠码即可兑换相应优惠券。新用户通过优惠通道注册并绑定微信，还可自动获得首月5折券，与周期折扣叠加后首月最低可至3.5折。</p></blockquote></section></section><section><h3>适用人群<a href="#适用人群"><span>#</span></a></h3><ul>
<li>✅ 预算有限的个人站长和博客主</li>
<li>✅ 想开游戏私服的学生党和玩家</li>
<li>✅ 学习Linux、Docker的技术爱好者</li>
<li>✅ 需要免备案海外机房的跨境电商和外贸站长</li>
</ul><hr /></section></section><section><h2>☁️ 联维云<a href="#️-联维云"><span>#</span></a></h2><p>联维云（cloud.lecway.com）是一家国产云服务商，</p><section><h3>核心亮点<a href="#核心亮点-1"><span>#</span></a></h3><p><strong>1. SLA承诺，稳定性有保障</strong></p><p>联维云承诺<strong>99.9%的服务可用性</strong>。对于企业用户来说，这种明确的稳定性承诺是选择服务商时的重要考量因素。云服务器交付速度快，官方宣称30分钟内即客服极速响应。</p><p><strong>2. 弹性计算，按需扩展</strong></p><p>联维云支持按需升降配，用户可以根据业务负载灵活调整资源配置，无需为闲置资源买单。这种弹性对于业务波动较大的初创公司和电商团队尤为实用。</p><p><strong>3. 安全防护体系完善</strong></p><p>在安全防护方面，联维云提供DDoS基础防护、数据加密和多重备份机制。T级网络带宽配合运营商多线BGP智能切换，能够在网络层面提供较好的容灾能力。</p><p><strong>4. 技术支持响应及时</strong></p><p>联维云提供<strong>7×24小时技术支持</strong>，工单系统30min内快速响应。对于企业客户来说，及时的技术支持意味着故障能在最短时间内得到处理，减少业务中断带来的损失。</p></section><section><h3>产品定位<a href="#产品定位"><span>#</span></a></h3><p>联维云的产品线相对聚焦，主要围绕<strong>弹性计算</strong>和<strong>个性化主机租用</strong>展开，强调为用户提供定制化的网络应用解决方案。从官网信息来看，其服务对象覆盖了从初创团队到成熟企业的各类客户群体。</p></section><section><h3>价格与优惠<a href="#价格与优惠-1"><span>#</span></a></h3><p>联维云的定价策略更偏向传统IDC服务商的透明化模式，强调”所见即所得”。<strong>目前联维云官方未提供通用的优惠码活动</strong>，用户可通过官网直接选购所需配置。对于长期合作的企业客户，建议直接联系商务咨询获取定制化方案和可能的批量折扣。</p><blockquote><p>📌 <strong>注意</strong>：联维云暂未提供类似雨云那样的公开优惠码体系，如有折扣需求，建议通过官网工单或商务渠道直接沟通。</p></blockquote></section><section><h3>适用人群<a href="#适用人群-1"><span>#</span></a></h3><ul>
<li>✅ 对稳定性有较高要求的中小企业</li>
<li>✅ 需要SLA保障的企业级应用</li>
<li>✅ 追求长期稳定合作的传统行业客户</li>
<li>✅ 需要定制化网络解决方案的团队</li>
</ul><hr /></section></section><section><h2>🔍 横向对比：如何选择？<a href="#-横向对比如何选择"><span>#</span></a></h2><p>为了更直观地帮助读者决策，我将两家服务商的核心差异整理如下：</p>

<table><thead><tr><th>对比维度</th><th>雨云（RainYun）</th><th>联维云（Lecway）</th></tr></thead><tbody><tr><td><strong>核心定位</strong></td><td>高性价比、玩家友好</td><td>稳定可靠、企业导向</td></tr><tr><td><strong>价格区间</strong></td><td>极低（月付10元起）</td><td>中等（按需定价）</td></tr><tr><td><strong>计费方式</strong></td><td>按天/按月/动态计费</td><td>弹性计费</td></tr><tr><td><strong>管理面板</strong></td><td>自研CMS，简洁易用</td><td>标准云控制台</td></tr><tr><td><strong>机房覆盖</strong></td><td>国内外多节点（美/日/港/国内）</td><td>国内BGP多线</td></tr><tr><td><strong>特色功能</strong></td><td>游戏云、积分返利、7天无理由</td><td>SLA承诺、T级BGP网络</td></tr><tr><td><strong>优惠力度</strong></td><td>首月5折 + 年付7折 + 优惠码</td><td>暂无公开优惠码</td></tr><tr><td><strong>适合人群</strong></td><td>个人站长、学生、游戏服主</td><td>中小企业、企业级用户</td></tr></tbody></table></section><section><h2>📝 写在最后<a href="#-写在最后"><span>#</span></a></h2><p>云服务器市场没有绝对的”最好”，只有”最适合”。</p><p>如果你还在犹豫，不妨先从雨云的入门配置开始试用——毕竟首月5折加上7天无理由退订，试错成本几乎为零。而对于已经有明确业务需求、追求稳定性的团队，联维云的SLA承诺和专业支持或许更能让你安心。</p><p>无论选择哪一家，都希望这篇文章能为你的上云之路提供一份有价值的参考。毕竟，选对服务器，项目就成功了一半。</p><hr /></section><section><h2>🔗 快速入口<a href="#-快速入口"><span>#</span></a></h2><ul>
<li><strong>雨云官网</strong>：<a href="https://www.rainyun.com/NjQ5Mzg2_" target="_blank">https://www.rainyun.com/NjQ5Mzg2_</a> — 注册即享新用户首月5折优惠(直达注册)</li>
<li><strong>联维云官网</strong>：<a href="https://cloud.lecway.com/aff/UFNXXEQU" target="_blank">https://cloud.lecway.com/aff/UFNXXEQU</a> — 企业级云服务，稳定可靠(直达注册)</li>
</ul><blockquote><p>💡 <strong>小贴士</strong>：雨云新用户别忘了在注册后绑定微信领取首月5折券，并在积分中心使用优惠码 <strong><code>NjQ5Mzg2</code></strong> 兑换额外优惠。联维云用户如有批量采购需求，建议直接通过官网商务咨询获取定制方案。</p></blockquote></section></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/pcl2-download/</id>
      <title type="text">PCL2 下载导航</title>
      <published>2026-07-23T00:00:00.000Z</published>
      <updated>2026-07-23T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/pcl2-download/"/>
      <summary type="text">PCL2 启动器各平台下载地址汇总，包含蓝奏云、夸克网盘和爱发电。</summary>
      <content type="html"><![CDATA[<section><h2>什么是 PCL2<a href="#什么是-pcl2"><span>#</span></a></h2><p>PCL2（Plain Craft Launcher 2）是一款由 LTCat 开发的 Minecraft 启动器，以简洁高效著称，支持离线登录、正版登录、模组管理等丰富功能，是国内最受欢迎的 Minecraft 第三方启动器之一。</p></section>
<section><h2>下载地址<a href="#下载地址"><span>#</span></a></h2><p>以下是 PCL2 的各平台下载入口：</p><section><h3>蓝奏云（密码：pcl2）<a href="#蓝奏云密码pcl2"><span>#</span></a></h3><p><a href="https://ltcat.lanzouv.com/b0aj6gsid" target="_blank">点击前往蓝奏云下载</a></p></section><section><h3>夸克网盘<a href="#夸克网盘"><span>#</span></a></h3><p><a href="https://pan.quark.cn/s/2470fff448b5" target="_blank">点击前往夸克网盘下载</a></p></section><section><h3>爱发电<a href="#爱发电"><span>#</span></a></h3><p><a href="https://www.ifdian.net/a/LTCat" target="_blank">点击前往爱发电支持 LTCat</a></p><hr /><p><em>建议优先使用蓝奏云下载，速度稳定无需客户端。</em></p></section></section>]]></content>
    </entry>
    <entry>
      <id>https://blog.qtfyu.top/posts/hello-blog/</id>
      <title type="text">这个博客，折腾了半个月才上线</title>
      <published>2026-07-22T00:00:00.000Z</published>
      <updated>2026-07-22T00:00:00.000Z</updated>
      <author><name>倾听风雨</name></author>
      <link rel="alternate" href="https://blog.qtfyu.top/posts/hello-blog/"/>
      <summary type="text">从零开始搭建一个个人博客的真实经历——选框架、换主题、踩坑、问人、再重来。半个月的折腾，记录一下。</summary>
      <content type="html"><![CDATA[<section><h2>为什么要自己搭博客<a href="#为什么要自己搭博客"><span>#</span></a></h2><p>其实想法很简单——想有个地方写点东西。不想要第三方平台的限制，不想要花里胡哨的广告，就想有一个干净的、完全属于自己的空间。平时可以记点技术踩坑的笔记，也可以偶尔写写生活里的碎碎念。</p><p>但真做起来才发现，从「我想」到「我做好了」，中间隔了十万八千里。</p></section>
<section><h2>选框架选了三天<a href="#选框架选了三天"><span>#</span></a></h2><p>一开始根本不知道从哪下手。问 deepseek 都各种不好，比如</p><ul>
<li>Hexo 和 Hugo 说生成静态快，但主题看了一圈总觉得不够现代</li>
<li>Next.js 太重型了，我觉得一个博客用不着</li>
<li>VuePress / VitePress 更适合写文档，不太像正经博客</li>
<li>最后看到了 Astro，轻量、静态生成、组件化，感觉对了</li>
</ul><p>然后又开始纠结主题。Github 上翻来翻去，好看的要么年久失修，要么功能太少。最后找到了 Firefly，颜值在线，功能也全，决定就是它了。</p></section>
<section><h2>学到了很多<a href="#学到了很多"><span>#</span></a></h2><p>虽然过程曲折，回头看看还挺有收获的：</p><ul>
<li><strong>从零理解了 Astro 的组件体系和路由机制</strong>，知道了 <code>.astro</code> 文件怎么跑</li>
<li><strong>学会了看报错日志</strong>，不再对着红屏一脸懵</li>
</ul></section>
<section><h2>接下来<a href="#接下来"><span>#</span></a></h2><p>博客上线只是个开始。之后打算慢慢把迁移过来的笔记整理好发上来，也会记录一些自己折腾过程中踩的坑。偶尔写点随想，就当是给自己的一个角落。</p><p>折腾半个月，值了。</p></section>]]></content>
    </entry>
</feed>
