<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>老侯 · 后会有期</title><description>AI、编程与技术的自留地</description><link>https://laohou.net/</link><templateTheme>Firefly</templateTheme><templateThemeVersion>6.11.0</templateThemeVersion><templateThemeUrl>https://github.com/CuteLeaf/Firefly</templateThemeUrl><lastBuildDate>2026年7月26日 22:28:31</lastBuildDate><item><title>4 个值得收藏的 Astro 博客主题</title><link>https://laohou.net/blog/astro-theme/</link><guid isPermaLink="true">https://laohou.net/blog/astro-theme/</guid><description>整理 4 个值得收藏的 Astro 博客主题：astro-koharu、Mizuki、Firefly 和 Fuwari。</description><pubDate>Sun, 26 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;section&gt;&lt;h1&gt;4 个值得收藏的 Astro 博客主题&lt;a href=&quot;#4-个值得收藏的-astro-博客主题&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h1&gt;&lt;p&gt;Astro 适合构建速度快、部署简单、内容体验优秀的静态博客。下面整理 4 个值得收藏的 Astro 主题，分别覆盖萌系二次元、Material Design、功能丰富和简洁实用等不同方向。&lt;/p&gt;&lt;section&gt;&lt;h2&gt;1. astro-koharu&lt;a href=&quot;#1-astro-koharu&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;&lt;/p&gt;&lt;figure&gt;&lt;img src=&quot;https://cms.laohou.net/uploads/astro_koharu_32f91da372.webp&quot; alt=&quot;astro-koharu.webp&quot; /&gt;&lt;figcaption&gt;astro-koharu.webp&lt;/figcaption&gt;&lt;/figure&gt;&lt;br /&gt;
&lt;code&gt;astro-koharu&lt;/code&gt; 是一个萌系、二次元风格的 Astro 博客主题，整体采用粉蓝配色，灵感来自 Hexo 的 Shoka 主题。它在视觉表现上比较活泼，同时也关注页面性能，适合喜欢个性化和二次元风格的个人博客。&lt;p&gt;&lt;/p&gt;&lt;a href=&quot;https://github.com/cosZone/astro-koharu&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;cosZone&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;astro-koharu&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;p&gt;项目特点：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;萌系和二次元视觉风格&lt;/li&gt;
&lt;li&gt;粉蓝配色&lt;/li&gt;
&lt;li&gt;基于 Astro、React、Tailwind CSS 和 TypeScript&lt;/li&gt;
&lt;li&gt;持续维护，适合二次开发&lt;/li&gt;
&lt;li&gt;使用 AGPL-3.0 开源协议&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;如果你希望博客有明显的个人风格，同时又不想从零设计主题，可以优先看看这个项目。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;2. Mizuki&lt;a href=&quot;#2-mizuki&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;&lt;/p&gt;&lt;figure&gt;&lt;img src=&quot;https://cms.laohou.net/uploads/Mizuki_51cd6c4917.webp&quot; alt=&quot;Mizuki.webp&quot; /&gt;&lt;figcaption&gt;Mizuki.webp&lt;/figcaption&gt;&lt;/figure&gt;&lt;br /&gt;
Mizuki 是一个基于 Astro 的下一代 Material Design 3 博客主题。它的设计语言更偏现代应用界面，适合喜欢结构化布局、Material 组件和丰富交互的用户。&lt;p&gt;&lt;/p&gt;&lt;a href=&quot;https://github.com/LyraVoid/Mizuki&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;LyraVoid&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;Mizuki&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;p&gt;项目特点：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;Material Design 3 风格&lt;/li&gt;
&lt;li&gt;Astro 驱动&lt;/li&gt;
&lt;li&gt;适合构建功能丰富的个人博客&lt;/li&gt;
&lt;li&gt;社区关注度较高&lt;/li&gt;
&lt;li&gt;使用 Apache-2.0 和 MIT 许可内容&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;Mizuki 的整体完成度和功能扩展性都比较好，更适合希望博客具备完整内容管理和多页面体验的用户。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;3. Firefly&lt;a href=&quot;#3-firefly&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;&lt;/p&gt;&lt;figure&gt;&lt;img src=&quot;https://cms.laohou.net/uploads/Firefly_283966575f.webp&quot; alt=&quot;Firefly.webp&quot; /&gt;&lt;figcaption&gt;Firefly.webp&lt;/figcaption&gt;&lt;/figure&gt;&lt;br /&gt;
Firefly 是一个清新美观的 Astro 静态博客主题，基于 Fuwari 进行二次开发。它在保持简洁博客体验的基础上，加入了更多实用功能和个性化设计。&lt;p&gt;&lt;/p&gt;&lt;a href=&quot;https://github.com/CuteLeaf/Firefly&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;CuteLeaf&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;Firefly&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;p&gt;项目特点：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;清新简洁的博客风格&lt;/li&gt;
&lt;li&gt;基于 Astro 和 Tailwind CSS&lt;/li&gt;
&lt;li&gt;支持静态部署&lt;/li&gt;
&lt;li&gt;具有较完整的文章、分类、标签和社交功能&lt;/li&gt;
&lt;li&gt;提供较丰富的 Markdown 扩展能力&lt;/li&gt;
&lt;li&gt;使用 MIT 开源协议&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;如果你希望快速搭建一个功能完整、视觉舒服的 Astro 博客，Firefly 是很值得收藏和参考的项目。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;4. Fuwari&lt;a href=&quot;#4-fuwari&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;&lt;/p&gt;&lt;figure&gt;&lt;img src=&quot;https://cms.laohou.net/uploads/fuwari_c9f1549d2a.webp&quot; alt=&quot;fuwari_c9f1549d2a.webp&quot; /&gt;&lt;figcaption&gt;fuwari_c9f1549d2a.webp&lt;/figcaption&gt;&lt;/figure&gt;&lt;br /&gt;
Fuwari 是一个简洁的 Astro 静态博客模板，强调清晰的内容排版和较低的上手成本。它拥有较高的社区关注度，也被不少 Astro 主题作为二次开发基础。&lt;p&gt;&lt;/p&gt;&lt;a href=&quot;https://github.com/saicaca/fuwari&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;saicaca&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;fuwari&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;p&gt;项目特点：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;简洁、现代的博客设计&lt;/li&gt;
&lt;li&gt;Astro 静态生成&lt;/li&gt;
&lt;li&gt;支持深色模式&lt;/li&gt;
&lt;li&gt;基于 Tailwind CSS&lt;/li&gt;
&lt;li&gt;支持 Markdown 内容写作&lt;/li&gt;
&lt;li&gt;使用 MIT 开源协议&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;Fuwari 适合希望快速开始写作、减少主题配置复杂度的用户，也适合作为学习 Astro 博客项目结构的起点。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;怎么选择&lt;a href=&quot;#怎么选择&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;





























&lt;table&gt;&lt;thead&gt;&lt;tr&gt;&lt;th&gt;主题&lt;/th&gt;&lt;th&gt;适合人群&lt;/th&gt;&lt;th&gt;风格&lt;/th&gt;&lt;/tr&gt;&lt;/thead&gt;&lt;tbody&gt;&lt;tr&gt;&lt;td&gt;astro-koharu&lt;/td&gt;&lt;td&gt;喜欢二次元和个性化设计的用户&lt;/td&gt;&lt;td&gt;萌系、粉蓝、活泼&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Mizuki&lt;/td&gt;&lt;td&gt;喜欢现代组件和 Material Design 的用户&lt;/td&gt;&lt;td&gt;现代、丰富、结构化&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Firefly&lt;/td&gt;&lt;td&gt;想快速搭建完整博客的用户&lt;/td&gt;&lt;td&gt;清新、实用、功能丰富&lt;/td&gt;&lt;/tr&gt;&lt;tr&gt;&lt;td&gt;Fuwari&lt;/td&gt;&lt;td&gt;想专注写作和内容排版的用户&lt;/td&gt;&lt;td&gt;简洁、轻量、现代&lt;/td&gt;&lt;/tr&gt;&lt;/tbody&gt;&lt;/table&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;使用前需要注意&lt;a href=&quot;#使用前需要注意&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;使用第三方主题前，建议先检查以下内容：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;Astro 和 Node.js 版本要求&lt;/li&gt;
&lt;li&gt;项目当前是否仍在维护&lt;/li&gt;
&lt;li&gt;开源协议是否适合你的用途&lt;/li&gt;
&lt;li&gt;是否需要修改默认配置和示例内容&lt;/li&gt;
&lt;li&gt;图片、评论、搜索等外部服务是否需要单独配置&lt;/li&gt;
&lt;li&gt;部署平台是否支持项目使用的适配器&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;主题可以直接使用，也可以作为学习和二次开发的基础。正式部署前建议先阅读项目 README，并在本地完成构建测试。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;结语&lt;a href=&quot;#结语&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;这 4 个主题各有特点：&lt;code&gt;astro-koharu&lt;/code&gt; 更偏个性化和二次元，Mizuki 更偏 Material Design 和丰富交互，Firefly 适合快速搭建完整博客，Fuwari 则更适合专注内容创作。&lt;/p&gt;&lt;p&gt;如果你正在寻找 Astro 博客主题，可以先根据视觉风格和功能需求筛选，再结合项目活跃度、许可证和部署要求做最终选择。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;</content:encoded></item><item><title>Hermes Studio 安装教程：从下载安装到验证</title><link>https://laohou.net/blog/hermes-studio-install/</link><guid isPermaLink="true">https://laohou.net/blog/hermes-studio-install/</guid><description>一篇面向国内用户的 Hermes Studio 安装教程，基于官方 README，介绍桌面版、npm、Docker Compose、源码开发运行和安装验证。</description><pubDate>Sat, 25 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;section&gt;&lt;h1&gt;Hermes Studio 安装教程：从下载安装到验证&lt;a href=&quot;#hermes-studio-安装教程从下载安装到验证&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h1&gt;&lt;p&gt;Hermes Studio 是面向 Hermes Agent 的桌面应用、本地运行时和 Web 控制台。它不是单独安装 &lt;code&gt;hermes-agent&lt;/code&gt; 命令行工具的教程，而是安装 &lt;strong&gt;Hermes Studio / Hermes Web UI&lt;/strong&gt;，用来在图形界面里管理聊天、模型、Profile、平台渠道、Cron 任务、文件、日志和 Coding Agent。&lt;/p&gt;&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/EKKOLearnAI/hermes-studio&quot; target=&quot;_blank&quot;&gt;https://github.com/EKKOLearnAI/hermes-studio&lt;/a&gt;&lt;/p&gt;&lt;a href=&quot;https://github.com/EKKOLearnAI/hermes-studio&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;EKKOLearnAI&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;hermes-studio&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;p&gt;&lt;img src=&quot;/assets/images/hermesstudio.webp&quot; alt=&quot;Hermes Studio 安装界面&quot; width=&quot;1280&quot; height=&quot;647&quot; loading=&quot;lazy&quot; /&gt;&lt;/p&gt;&lt;section&gt;&lt;h2&gt;适合谁安装&lt;a href=&quot;#适合谁安装&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果你希望用浏览器或桌面界面来管理 Hermes，而不是只在终端里使用 &lt;code&gt;hermes&lt;/code&gt;，就应该安装 Hermes Studio。&lt;/p&gt;&lt;p&gt;它主要提供这些能力：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;图形化聊天界面&lt;/li&gt;
&lt;li&gt;模型和 Provider 管理&lt;/li&gt;
&lt;li&gt;Hermes Profile 管理&lt;/li&gt;
&lt;li&gt;平台渠道接入配置&lt;/li&gt;
&lt;li&gt;定时任务、Kanban、群聊管理&lt;/li&gt;
&lt;li&gt;文件浏览器、Web 终端、日志查看&lt;/li&gt;
&lt;li&gt;Coding Agent 启动和监控&lt;/li&gt;
&lt;/ul&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;安装方式一：桌面应用（推荐）&lt;a href=&quot;#安装方式一桌面应用推荐&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;最推荐普通用户直接下载桌面版。&lt;/p&gt;&lt;p&gt;打开 GitHub Releases：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;https://github.com/EKKOLearnAI/hermes-studio/releases/latest&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;根据自己的系统下载对应安装包：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;Windows：下载 Windows 安装包&lt;/li&gt;
&lt;li&gt;macOS：下载 macOS 安装包&lt;/li&gt;
&lt;li&gt;Linux：下载 Linux 安装包&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;安装完成后直接打开 &lt;strong&gt;Hermes Studio&lt;/strong&gt; 即可。&lt;/p&gt;&lt;p&gt;桌面版会内置 Web UI 运行时，并且会使用原生 Hermes 数据目录：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;Windows：&lt;code&gt;%LOCALAPPDATA%\hermes&lt;/code&gt;，找不到时回退到 &lt;code&gt;%APPDATA%\hermes&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;macOS / Linux：&lt;code&gt;~/.hermes&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;Web UI 自身状态默认保存在：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;~/.hermes-web-ui&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;安装方式二：npm 安装 Hermes Web UI&lt;a href=&quot;#安装方式二npm-安装-hermes-web-ui&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果你是在服务器上部署，或者想用浏览器访问 Web 控制台，可以使用 npm 安装。&lt;/p&gt;&lt;p&gt;先确认服务器已经有 Node.js，然后执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-g&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;start&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;启动后打开：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;http://localhost:8648&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果你在服务器上运行，需要把 &lt;code&gt;localhost&lt;/code&gt; 换成服务器 IP 或者你配置好的域名。&lt;/p&gt;&lt;p&gt;常用维护命令：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;status&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;restart&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;stop&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;update&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果要指定端口启动：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;start&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--port&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;9000&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;然后访问：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;http://localhost:9000&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;安装方式三：Docker Compose 部署&lt;a href=&quot;#安装方式三docker-compose-部署&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果你更喜欢容器化部署，可以使用 Docker Compose。&lt;/p&gt;&lt;p&gt;官方 README 里的推荐命令是：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;WEBUI_IMAGE&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;ekkoye8888/hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;docker&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;compose&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;up&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-d&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果你想从源码构建，也可以进入项目目录后执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;docker&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;compose&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;up&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-d&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--build&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;查看日志：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;docker&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;compose&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;logs&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-f&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;hermes-webui&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;Docker Compose 默认访问地址：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;http://localhost:6060&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;默认数据目录：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;./hermes_data&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;首次启动并开启认证时，认证 Token 会打印在容器日志里；Web UI 的 token 默认保存在：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;./hermes_data/hermes-web-ui/.token&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;开发者源码运行&lt;a href=&quot;#开发者源码运行&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果你是开发者，想从源码启动 Hermes Studio，可以使用下面流程：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;git&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;clone&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;https://github.com/EKKOLearnAI/hermes-studio.git&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;cd&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;hermes-studio&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;run&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;dev&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;开发环境默认端口：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;前端：&lt;code&gt;http://localhost:8649&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;BFF 后端：&lt;code&gt;http://localhost:8647&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;构建生产版本：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;run&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;build&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;首次登录和认证&lt;a href=&quot;#首次登录和认证&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;Hermes Studio 支持 Token 认证，也支持用户名和密码登录。&lt;/p&gt;&lt;p&gt;默认登录信息通常是：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;用户名：admin&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;密码：123456&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;首次登录后建议马上修改默认密码。&lt;/p&gt;&lt;p&gt;如果忘记默认账号密码，可以在服务器上执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;reset-default-login&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果登录 IP 被锁，可以执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;clear-login-locks&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果需要清理登录锁并重启服务：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;clear-login-locks&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--restart&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;验证是否安装成功&lt;a href=&quot;#验证是否安装成功&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;安装完成后，可以按下面几步检查。&lt;/p&gt;&lt;section&gt;&lt;h3&gt;1. 检查服务状态&lt;a href=&quot;#1-检查服务状态&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;npm 安装方式可以执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;status&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;Docker Compose 部署可以执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;docker&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;compose&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;ps&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;docker&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;compose&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;logs&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-f&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;hermes-webui&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;2. 打开 Web 页面&lt;a href=&quot;#2-打开-web-页面&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;根据安装方式访问对应地址：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm 默认：http://localhost:8648&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;Docker 默认：http://localhost:6060&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;开发环境前端：http://localhost:8649&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;能看到登录页或控制台页面，就说明 Web UI 已经正常启动。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;3. 检查 Hermes Agent 运行时&lt;a href=&quot;#3-检查-hermes-agent-运行时&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;Hermes Studio 是图形界面和控制台，但底层聊天能力仍然依赖 Hermes Agent 运行时。&lt;/p&gt;&lt;p&gt;Web UI 会优先寻找包含 &lt;code&gt;run_agent.py&lt;/code&gt; 的 Hermes Agent 源码目录，例如：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;~/.hermes/hermes-agent&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果找不到源码目录，会退回到系统里已安装的 &lt;code&gt;hermes&lt;/code&gt; 命令环境。&lt;/p&gt;&lt;p&gt;所以如果聊天无法运行，可以检查：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--help&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;4. 新建一条测试会话&lt;a href=&quot;#4-新建一条测试会话&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;进入 Hermes Studio 后，新建一条聊天会话，发送一句：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;你好，测试一下是否可以正常回复&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果能正常流式回复，说明 Web UI、Agent Bridge 和模型配置基本都正常。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;常见问题&lt;a href=&quot;#常见问题&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;section&gt;&lt;h3&gt;1. &lt;code&gt;hermes-web-ui&lt;/code&gt; 命令不存在&lt;a href=&quot;#1-hermes-web-ui-命令不存在&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;说明 npm 全局安装没有成功，或者 npm 全局 bin 目录没有加入 PATH。&lt;/p&gt;&lt;p&gt;可以重新安装：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-g&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;然后重新打开终端再试。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;2. 页面打不开&lt;a href=&quot;#2-页面打不开&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;先检查服务是否启动：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;status&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;再检查端口是否被占用或被防火墙拦截。&lt;/p&gt;&lt;p&gt;npm 默认端口是 &lt;code&gt;8648&lt;/code&gt;，Docker 默认端口是 &lt;code&gt;6060&lt;/code&gt;。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;3. 能打开页面，但聊天不能用&lt;a href=&quot;#3-能打开页面但聊天不能用&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;通常是 Hermes Agent 运行时或模型配置问题。可以在服务器上执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;model&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;先确认 Hermes Agent 本身可用，再回到 Hermes Studio 里测试聊天。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;4. 想升级到最新版&lt;a href=&quot;#4-想升级到最新版&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;npm 安装方式可以执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;update&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;或者：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes-web-ui&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;upgrade&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;Docker 部署则重新拉取镜像并启动即可。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;总结&lt;a href=&quot;#总结&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;安装 Hermes Studio 有三条主线：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;普通桌面用户：下载 GitHub Releases 桌面版&lt;/li&gt;
&lt;li&gt;服务器 Web 控制台：&lt;code&gt;npm install -g hermes-web-ui &amp;amp;&amp;amp; hermes-web-ui start&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Docker 部署：&lt;code&gt;WEBUI_IMAGE=ekkoye8888/hermes-web-ui docker compose up -d&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;注意，这篇教程安装的是 &lt;strong&gt;Hermes Studio / Hermes Web UI&lt;/strong&gt;，不是只安装 Hermes Agent CLI。Hermes Agent 是底层运行时，Hermes Studio 是用来管理和使用它的图形化工作台。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;</content:encoded></item><item><title>使用 Hermes Agent 安装 Google PageSpeed 优化网站</title><link>https://laohou.net/blog/pagespeed/</link><guid isPermaLink="true">https://laohou.net/blog/pagespeed/</guid><description>使用 Hermes Agent 接入 PageSpeed MCP Server，配置 Google PageSpeed Insights API，并分析和优化网站性能。</description><pubDate>Fri, 24 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;section&gt;&lt;h1&gt;使用 Hermes Agent 安装 Google PageSpeed 优化网站&lt;a href=&quot;#使用-hermes-agent-安装-google-pagespeed-优化网站&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h1&gt;&lt;p&gt;网站速度和 Core Web Vitals 会影响用户体验，也会影响搜索引擎对页面质量的判断。现在可以让 Hermes Agent 接入 PageSpeed MCP Server，直接帮你测试网站、分析问题，并根据报告协助优化。&lt;br /&gt;
&lt;/p&gt;&lt;figure&gt;&lt;img src=&quot;https://cms.laohou.net/uploads/pagespeed_71bf8022fe.webp&quot; alt=&quot;pagespeed&quot; /&gt;&lt;figcaption&gt;pagespeed&lt;/figcaption&gt;&lt;/figure&gt;&lt;br /&gt;
本文以自己的站点为例，介绍如何配置 Google PageSpeed Insights API，并让 Hermes Agent 调用 PageSpeed 工具完成网站性能优化。&lt;p&gt;&lt;/p&gt;&lt;p&gt;项目地址：&lt;a href=&quot;https://github.com/PhialsBasement/Pagespeed-MCP-Server&quot; target=&quot;_blank&quot;&gt;https://github.com/PhialsBasement/Pagespeed-MCP-Server&lt;/a&gt;&lt;/p&gt;&lt;a href=&quot;https://github.com/PhialsBasement/Pagespeed-MCP-Server&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;PhialsBasement&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;Pagespeed-MCP-Server&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;section&gt;&lt;h2&gt;PageSpeed MCP Server 是什么&lt;a href=&quot;#pagespeed-mcp-server-是什么&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;PageSpeed MCP Server 是一个 MCP 服务，它把 Google PageSpeed Insights 的测试能力提供给 AI 助手使用。配置完成后，可以让 Hermes Agent：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;测试网站的移动端和桌面端性能&lt;/li&gt;
&lt;li&gt;查看 Performance、Accessibility、Best Practices 和 SEO 分数&lt;/li&gt;
&lt;li&gt;分析 LCP、CLS、INP 等 Core Web Vitals&lt;/li&gt;
&lt;li&gt;找出图片过大、阻塞渲染、缓存配置等问题&lt;/li&gt;
&lt;li&gt;根据报告给出优化方案&lt;/li&gt;
&lt;li&gt;协助修改网站后重新验证&lt;/li&gt;
&lt;/ul&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;获取 Google PageSpeed API 密钥&lt;a href=&quot;#获取-google-pagespeed-api-密钥&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;section&gt;&lt;h3&gt;1. 进入 Google Cloud Console&lt;a href=&quot;#1-进入-google-cloud-console&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;打开 &lt;a href=&quot;https://console.cloud.google.com/&quot; target=&quot;_blank&quot;&gt;Google Cloud Console&lt;/a&gt;，登录 Google 账号。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;2. 创建或选择项目&lt;a href=&quot;#2-创建或选择项目&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;点击页面顶部的项目下拉菜单，创建新项目，或者选择已有项目。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;3. 启用 PageSpeed Insights API&lt;a href=&quot;#3-启用-pagespeed-insights-api&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;进入 API 库，搜索 &lt;strong&gt;PageSpeed Insights API&lt;/strong&gt;，打开对应服务后点击“启用”。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;4. 创建 API 密钥&lt;a href=&quot;#4-创建-api-密钥&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;在左侧菜单进入“凭据”（Credentials），点击“+ 创建凭据”，选择“API 密钥”。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;5. 复制并保存密钥&lt;a href=&quot;#5-复制并保存密钥&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;Google Cloud 会生成一串 API 密钥。请立即复制并妥善保存，不要把密钥写进公开文章、GitHub 仓库或前端代码中。生产环境建议限制密钥的 API 使用范围，并定期轮换。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;安装 PageSpeed MCP Server&lt;a href=&quot;#安装-pagespeed-mcp-server&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;先确认机器上已经安装 Git、Node.js 和 npm：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;git&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--version&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;node&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--version&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--version&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;然后克隆项目：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;git&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;clone&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;https://github.com/PhialsBasement/Pagespeed-MCP-Server.git&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;cd&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;Pagespeed-MCP-Server&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;npm&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;根据项目 README 的说明完成构建或启动。不同版本的启动命令可能会变化，建议以仓库当前 README 为准。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;配置 Hermes Agent&lt;a href=&quot;#配置-hermes-agent&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;把 PageSpeed MCP Server 加入 Hermes Agent 的 MCP 配置，并将 API 密钥放进环境变量：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;export&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;PAGESPEED_API_KEY&lt;/span&gt;&lt;span&gt;=&lt;/span&gt;&lt;span&gt;&quot;你的 Google PageSpeed API 密钥&quot;&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;建议通过环境变量、密钥文件或系统服务配置注入，不要把真实密钥直接提交到配置仓库。&lt;/p&gt;&lt;p&gt;配置完成后重启 Hermes Agent，并检查工具：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;tools&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果能看到 PageSpeed 相关 MCP 工具，说明服务发现和配置基本正常。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;让 Hermes Agent 测试网站&lt;a href=&quot;#让-hermes-agent-测试网站&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;可以直接发送：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;请使用 PageSpeed 测试 https://laohou.net，分别检查移动端和桌面端，列出 Performance、Accessibility、Best Practices、SEO 分数，并优先分析影响 LCP 和移动端体验的问题。&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;也可以测试具体页面：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;请测试 https://laohou.net/blog/hermes-studio-install/，给出可以直接修改的优化项，并说明修改后如何验证。&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;建议同时检查首页、文章页、关于页和移动端页面，避免只优化一个页面却破坏其他页面的排版或交互。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;这次网站优化的实际效果&lt;a href=&quot;#这次网站优化的实际效果&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;以 &lt;code&gt;laohou.net&lt;/code&gt; 的优化过程为例，PageSpeed 和浏览器验证帮助定位并处理了几类问题：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;优化图片加载，避免使用明显大于实际显示尺寸的资源&lt;/li&gt;
&lt;li&gt;保留 Astro Image 的响应式处理和图片质量配置&lt;/li&gt;
&lt;li&gt;调整 CSS 加载范围，减少不必要的全局阻塞资源&lt;/li&gt;
&lt;li&gt;保留文章页 Markdown 排版、代码块样式和 Fancybox 图片预览&lt;/li&gt;
&lt;li&gt;修复 Fancybox 通过 &lt;code&gt;data:&lt;/code&gt; 模块动态加载导致的 CSP 报错，改为由 Vite 正常打包&lt;/li&gt;
&lt;li&gt;重新构建并部署网站后，用真实浏览器检查文章页&lt;/li&gt;
&lt;li&gt;最终浏览器控制台无 JavaScript 错误，相关 CSS 请求返回正常&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;优化不能只看分数，还要确认文章内容、导航、图片预览和移动端布局没有被破坏。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;推荐的优化流程&lt;a href=&quot;#推荐的优化流程&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;PageSpeed 测试 → Hermes Agent 分析报告 → 确认影响范围 → 修改 Astro 源码 → 重新构建部署 → 浏览器验证 → 再次运行 PageSpeed 对比&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;每次只处理一组相关问题，并记录修改前后的分数和 Core Web Vitals，比较容易判断优化是否真的有效。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;常见问题&lt;a href=&quot;#常见问题&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;section&gt;&lt;h3&gt;API 请求被拒绝&lt;a href=&quot;#api-请求被拒绝&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;检查 PageSpeed Insights API 是否已启用、API 密钥是否正确，以及项目配额是否用完。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;Hermes 看不到 PageSpeed 工具&lt;a href=&quot;#hermes-看不到-pagespeed-工具&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;检查 MCP Server 是否成功启动、Node.js 依赖是否安装完成，并运行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;tools&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;修改配置后记得重启 Hermes Agent。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;测试结果不稳定&lt;a href=&quot;#测试结果不稳定&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;PageSpeed 会受到测试节点、网络、缓存和服务器负载影响。不要只看一次测试，建议在相近条件下重复测试并观察趋势。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;结语&lt;a href=&quot;#结语&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;通过 PageSpeed MCP Server，Hermes Agent 可以把“测试网站—分析报告—修改源码—重新验证”串成一个工作流。准备好 Google PageSpeed Insights API 密钥后，根据项目 README 完成 MCP Server 配置即可。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;</content:encoded></item><item><title>Hermes Agent 安装教程：Linux 和 Windows</title><link>https://laohou.net/blog/hermes-agent-install/</link><guid isPermaLink="true">https://laohou.net/blog/hermes-agent-install/</guid><description>一篇面向国内用户的 Hermes Agent 安装教程，分别介绍 Linux 和 Windows 的安装方式、启动方式与验证方法。</description><pubDate>Wed, 22 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;section&gt;&lt;h1&gt;Hermes Agent 安装教程：Linux 和 Windows&lt;a href=&quot;#hermes-agent-安装教程linux-和-windows&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h1&gt;&lt;p&gt;Hermes Agent 是一个可以在终端、桌面端和消息平台上运行的 AI 助手。对于大多数用户，最省事的安装方式就是直接用官方安装脚本；如果你用的是 Windows，则可以直接走官方 PowerShell 安装方式，省掉很多手动配置步骤。&lt;/p&gt;&lt;a href=&quot;https://github.com/NousResearch/hermes-agent&quot; target=&quot;_blank&quot;&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;NousResearch&lt;/div&gt;&lt;/div&gt;&lt;div&gt;/&lt;/div&gt;&lt;div&gt;hermes-agent&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;Waiting for api.github.com...&lt;/div&gt;&lt;div&gt;&lt;div&gt;00K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;div&gt;0K&lt;/div&gt;&lt;span&gt;Waiting...&lt;/span&gt;&lt;/div&gt;&lt;/a&gt;&lt;p&gt;这篇文章只讲最实用的两条路径：Linux 安装和 Windows 安装。&lt;/p&gt;&lt;section&gt;&lt;h2&gt;安装前准备&lt;a href=&quot;#安装前准备&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;先确认下面这些基础条件已经满足：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;能正常访问 Hermes 官方网站&lt;/li&gt;
&lt;li&gt;机器上有 &lt;code&gt;git&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Linux 下建议有 &lt;code&gt;curl&lt;/code&gt; 和 &lt;code&gt;xz-utils&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Windows 使用 PowerShell 进行安装&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;官方文档里提到，安装器会自动处理 Python、Node.js、ripgrep、ffmpeg 等依赖，所以一般不需要你手动装这些组件。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;Linux 安装&lt;a href=&quot;#linux-安装&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;Linux 上最简单的方式是直接执行官方安装脚本：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;安装完成后，刷新当前 shell：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;source ~/.bashrc&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;然后启动 Hermes：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果你想先检查安装情况，可以直接运行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;section&gt;&lt;h3&gt;Linux 常见补充&lt;a href=&quot;#linux-常见补充&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;如果你是 Debian 或 Ubuntu，官方文档建议先确保这两个包存在：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;sudo apt install curl xz-utils&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果你要使用桌面端，通常还需要编译相关依赖：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;sudo apt install build-essential&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;Linux 安装后的常用命令&lt;a href=&quot;#linux-安装后的常用命令&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes model&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes tools&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;5&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes setup&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;6&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;7&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes config check&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;这些命令分别用于选择模型、配置工具、运行向导和检查配置。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;Windows 安装&lt;a href=&quot;#windows-安装&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;Windows 原生安装可以直接在 PowerShell 里执行官方安装命令：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;iex (irm https://hermes-agent.nousresearch.com/install.ps1)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;安装完成后，打开新的 PowerShell 窗口，直接运行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果你想检查是否安装正常：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;Windows 桌面端&lt;a href=&quot;#windows-桌面端&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果你更想要图形界面，官方也提供 Hermes Desktop。安装完命令行后，也可以直接运行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes desktop&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;验证是否安装成功&lt;a href=&quot;#验证是否安装成功&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;无论 Linux 还是 Windows，最直接的验证方式都是这三个动作：&lt;/p&gt;&lt;ol&gt;
&lt;li&gt;&lt;code&gt;hermes doctor&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;hermes model&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;&lt;code&gt;hermes&lt;/code&gt;&lt;/li&gt;
&lt;/ol&gt;&lt;p&gt;如果 &lt;code&gt;hermes doctor&lt;/code&gt; 能正常跑完，说明主体安装基本没问题；如果能进入交互界面并正常发消息，说明可用。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;推荐的安装路径&lt;a href=&quot;#推荐的安装路径&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果你只是想尽快用起来，推荐顺序是：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;Linux：直接跑 &lt;code&gt;install.sh&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;Windows：直接跑 &lt;code&gt;install.ps1&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;需要图形界面：安装后再开 &lt;code&gt;hermes desktop&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;常见问题&lt;a href=&quot;#常见问题&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;section&gt;&lt;h3&gt;1. 提示找不到 &lt;code&gt;hermes&lt;/code&gt;&lt;a href=&quot;#1-提示找不到-hermes&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;先重新打开终端，或者执行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;source ~/.bashrc&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;Windows 则打开一个新的 PowerShell 窗口再试。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;2. 提示缺少 API Key&lt;a href=&quot;#2-提示缺少-api-key&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;先运行：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes model&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;按照向导选择你的模型提供方，再继续使用。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h3&gt;3. 安装后想调整配置&lt;a href=&quot;#3-安装后想调整配置&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h3&gt;&lt;p&gt;你可以随时使用这些命令：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes setup&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;3&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes config set&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;4&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;5&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes config check&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;6&lt;/div&gt;&lt;/div&gt;&lt;div&gt;
&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;7&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;hermes doctor&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;结尾&lt;a href=&quot;#结尾&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;Hermes 的安装并不复杂，核心就是选对平台，然后用官方安装脚本完成初始化。Linux 用 &lt;code&gt;install.sh&lt;/code&gt;，Windows 用 &lt;code&gt;install.ps1&lt;/code&gt;，后面再根据需要配置模型和工具即可。&lt;/p&gt;&lt;p&gt;如果你要把它接到自己的工作流里，后面最值得继续看的就是模型配置、工具开关和技能系统。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;</content:encoded></item><item><title>V2Ray 安装教程：从准备服务器到客户端连接</title><link>https://laohou.net/blog/v2ray-install/</link><guid isPermaLink="true">https://laohou.net/blog/v2ray-install/</guid><description>一篇面向新手的 V2Ray 安装教程，包含服务器准备、一键脚本安装、协议选择、防火墙放行和客户端连接检查。</description><pubDate>Sun, 19 Jul 2026 00:00:00 GMT</pubDate><content:encoded>&lt;section&gt;&lt;h1&gt;V2Ray 安装教程：从准备服务器到客户端连接&lt;a href=&quot;#v2ray-安装教程从准备服务器到客户端连接&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h1&gt;&lt;p&gt;V2Ray 是常见的代理工具，适合用来搭建自己的网络代理服务。本文用最省事的一键脚本方式，走一遍从服务器准备到客户端连接的完整流程。&lt;/p&gt;&lt;section&gt;&lt;h2&gt;准备工作&lt;a href=&quot;#准备工作&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;开始前先准备好这些东西：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;一台海外 VPS&lt;/li&gt;
&lt;li&gt;一个已经解析到服务器 IP 的域名&lt;/li&gt;
&lt;li&gt;SSH 登录权限&lt;/li&gt;
&lt;li&gt;系统建议使用 Debian 11/12 或 Ubuntu 20.04/22.04&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;如果只是测试，也可以先不用域名，但正式使用建议配合域名和 TLS。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;安装 curl&lt;a href=&quot;#安装-curl&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;Debian / Ubuntu：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;apt&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;update&lt;/span&gt;&lt;span&gt; &amp;amp;&amp;amp; &lt;/span&gt;&lt;span&gt;apt&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-y&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;curl&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;CentOS：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;yum&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;install&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-y&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;curl&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;执行一键安装脚本&lt;a href=&quot;#执行一键安装脚本&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;下面是常见的一键安装方式：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;bash&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;&amp;lt;(&lt;/span&gt;&lt;span&gt;curl&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-sL&lt;/span&gt;&lt;span&gt; https://raw.githubusercontent.com/daveleung/hijkpw-scripts-mod/main/xray_mod1.sh)&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;运行后按脚本提示选择协议、端口和域名即可。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;协议怎么选&lt;a href=&quot;#协议怎么选&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;常见选择如下：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;&lt;code&gt;VMESS + WS + TLS&lt;/code&gt;：兼容性好，适合新手&lt;/li&gt;
&lt;li&gt;&lt;code&gt;VLESS + WS + TLS&lt;/code&gt;：更现代，也适合过 CDN&lt;/li&gt;
&lt;li&gt;&lt;code&gt;VLESS + TCP + XTLS&lt;/code&gt;：性能好，但客户端兼容要求更高&lt;/li&gt;
&lt;li&gt;&lt;code&gt;Trojan&lt;/code&gt;：伪装简单，使用也比较方便&lt;/li&gt;
&lt;/ul&gt;&lt;p&gt;如果你不确定选什么，优先选 &lt;code&gt;VMESS + WS + TLS&lt;/code&gt; 或 &lt;code&gt;VLESS + WS + TLS&lt;/code&gt;。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;放行端口&lt;a href=&quot;#放行端口&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果服务器开启了防火墙，需要放行对应端口。比如使用 443：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;ufw&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;allow&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;443/tcp&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果是 CentOS firewalld：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;firewall-cmd&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--permanent&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--add-port=443/tcp&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;2&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;firewall-cmd&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;--reload&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;客户端连接&lt;a href=&quot;#客户端连接&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;安装完成后，脚本通常会输出连接信息或订阅链接。把它导入到客户端即可。&lt;/p&gt;&lt;p&gt;常见客户端：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;Windows：v2rayN&lt;/li&gt;
&lt;li&gt;Android：v2rayNG&lt;/li&gt;
&lt;li&gt;iOS：Shadowrocket / Stash&lt;/li&gt;
&lt;li&gt;macOS：V2rayU / Clash Verge&lt;/li&gt;
&lt;/ul&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;检查是否成功&lt;a href=&quot;#检查是否成功&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;连接后可以打开浏览器测试网络，也可以在服务器上检查端口是否监听：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;ss&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;-tlnp&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果客户端连不上，优先检查：&lt;/p&gt;&lt;ul&gt;
&lt;li&gt;域名是否解析到服务器&lt;/li&gt;
&lt;li&gt;端口是否被防火墙放行&lt;/li&gt;
&lt;li&gt;TLS 证书是否正常&lt;/li&gt;
&lt;li&gt;客户端 UUID、路径、端口是否填错&lt;/li&gt;
&lt;li&gt;CDN 是否开启了 WebSocket&lt;/li&gt;
&lt;/ul&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;BBR 加速&lt;a href=&quot;#bbr-加速&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;如果网络速度一般，可以开启 BBR：&lt;/p&gt;&lt;div&gt;&lt;figure&gt;&lt;figcaption&gt;&lt;span&gt;&lt;/span&gt;&lt;span&gt;Terminal window&lt;/span&gt;&lt;/figcaption&gt;&lt;pre&gt;&lt;code&gt;&lt;div&gt;&lt;div&gt;&lt;div&gt;1&lt;/div&gt;&lt;/div&gt;&lt;div&gt;&lt;span&gt;lsmod&lt;/span&gt;&lt;span&gt; | &lt;/span&gt;&lt;span&gt;grep&lt;/span&gt;&lt;span&gt; &lt;/span&gt;&lt;span&gt;bbr&lt;/span&gt;&lt;/div&gt;&lt;/div&gt;&lt;/code&gt;&lt;/pre&gt;&lt;div&gt;&lt;div&gt;&lt;/div&gt;&lt;div&gt;&lt;/div&gt;&lt;/div&gt;&lt;/figure&gt;&lt;/div&gt;&lt;p&gt;如果没有开启，再根据系统版本单独配置。不要盲目叠加多个加速脚本，容易把网络环境搞乱。&lt;/p&gt;&lt;/section&gt;&lt;section&gt;&lt;h2&gt;总结&lt;a href=&quot;#总结&quot;&gt;&lt;span&gt;#&lt;/span&gt;&lt;/a&gt;&lt;/h2&gt;&lt;p&gt;新手最稳的路线是：海外 VPS + 域名 + &lt;code&gt;VLESS/VMESS + WS + TLS&lt;/code&gt;。先保证能连，再考虑 CDN、BBR 和更复杂的伪装配置。&lt;/p&gt;&lt;/section&gt;&lt;/section&gt;</content:encoded></item></channel></rss>