微服网络隔离，如何实现应用互联？

**懒猫微服平台中的应用默认享有网络隔离，类似Docker容器间隔离。若需两个应用互访，可通过端口转发工具配置实现。** [以Radarr和Jackett为例](https://playground.lazycat.cloud/#/guideline/295) **端口转发部分配置** 在懒猫商店下载局域网端口转发工具，用于映射Jackett应用端口被Radarr访问 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 局域网网路地址： ```bash 局域网出口类型：选择"微服虚拟网卡（仅微服应用容器内可访问）" 微服虚拟网卡：host.lzcapp 端口：9117（建议与应用内） ``` 目标转发地址： ```bash 转发目标类型：选择"微服应用" 微服应用:选择"Jackett"(这里注意一定看一下Jackett的状态是否running，如果显示stopped，关闭"端口转发应用"在重新打开 server tcp 9117 ```   配置完成后测试连接——>并保存 ## Radarr软件 Jackett软件配置完成后，从商店中查找并安装Radarr软件。下载安装完成后对其进行相关配置。 - 下载客户端 软件上架时会将下载器一起打包，所以这里就不需要配置下载器了，默认已经配置完成。下载器默认下载的路径为 “/home/下载” 目录。  - 索引器 点击索引器按钮菜单，点击“添加索引器”按钮，选择“Torznab”进行相关配置。 填写相关参数： ```bash 名称：建议填写Jackett中Indexer的名称 URL：点击Jackett中Indexer的Copy Torznab Feed 这里需要注意，默认复制出来的域名是https://jackett.微服名.heiyu.space/api/v2.0/indexers/Indexer名/results/torznab/ 需要修改两处："https"改为"http"；"jackett.微服名.heiyu.space"改为"host.lzcapp:9117" API Key：Jackett中左上角复制填入 ```  URL和API Key填写成功以后，点击“Categories”会自动弹出列表，在列表中选择需要的分类。   添加完成后点击测试，没有问题后点击保存，按照上面的方法可以添加多个索引。 

买微服血赚攻略：我的世界服务器本地部署

苦于各类云服务器好一点的配置/流畅的带宽任何一项加一点都很贵，并且到期时要是忘记把数据拿到本地，就会永久丢失了，于是这一篇攻略就出来了。不止配置我的世界服务器，很多类似的服务部署都可以参考这一篇懒猫的网络配置方案。 使用到的应用： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.lightos.entry 可选应用： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 这篇攻略会做的事情： 1、在LightOS内创建合适的镜像 2、服务器版本选择及对应Java环境部署和安装 3、配置端口转发 4、联机及客户端配置 一、选择镜像 进入LightOS --- 点击创建 这里使用Arch Linux 镜像，勾选基础软件包安装开发基础工具 常用CLI工具。  点下一步  填写自定义的用户名密码后点击创建  二、配置环境 随着版本更迭，挺多版本都会进行Java版本的更新，Java服务端和版本配置挺难解决的，这里统一给出来： 1、Minecraft 版本和 Java 版本常见对应关系： |Minecraft 版本|建议 Java| |---|---| |1.20.5 及以上、1.21.x|Java 21| |1.18 到 1.20.4|Java 17| |1.17.x|Java 16 或 Java 17，按服务端核心要求| |1.16.5 及更旧|老 Forge 整合包常见 Java 8，具体看整合包说明| 先更新系统并安装常用工具（需要安装）： ```bash sudo pacman -Syu sudo pacman -S curl wget unzip screen tmux vi traceroute ``` OpenJDK 包名常用这些（选择一个安装）： ```bash sudo pacman -S jdk8-openjdk sudo pacman -S jdk17-openjdk sudo pacman -S jdk21-openjdk sudo pacman -S jdk25-openjdk ``` 查看已安装 Java（可选）： ```bash archlinux-java status ``` 切换 Java 版本（可选）： ```bash sudo archlinux-java set java-17-openjdk sudo archlinux-java set java-21-openjdk sudo archlinux-java set java-25-openjdk ``` 如果你不知道选哪个，当前新服优先用 Minecraft 1.21.x + Java 21。除非你要跑最新 Paper 26.1+，否则多数 1.21.x 服务器用 Java 21 更稳妥。Paper 官方文档目前说明 1.20 到 1.21.11 推荐 Java 21，Paper 26.1+ 要求 Java 25。 确认 Java 可用（可选）： ```bash java -version ``` 如果系统里装了多个 Java 版本， Java 管理工具查看（可选）： ```bash archlinux-java status ``` 切换到 Java 21（可选）： ```bash sudo archlinux-java set java-21-openjdk ``` 2、服务端类型怎么选（第2小章是原版、第3小章是mod版，可酌情选择配置） | 类型 | 适合场景 | 客户端是否需要额外安装 | | ---------------- | ----------------------- | ----------- | | Vanilla 原版/纯净版 | 原版生存、建筑、红石，最少兼容问题 | 不需要 | | Paper / Purpur | 更好性能、权限、领地、经济、登录等插件 | 通常不需要 | | Fabric | 轻量 MOD、性能 MOD、现代 MOD 生态 | MOD 服通常需要 | | Forge / NeoForge | 大型整合包、科技、魔法、冒险类 MOD | 通常需要 | 新手建议： - 只想和朋友玩原版生存：选 Vanilla 或 Paper。 - 想要插件、权限、领地、经济：选 Paper。 - 想玩 MOD：按 MOD 或整合包要求选择 Fabric、Forge 或 NeoForge，不要混用加载器。 3、纯净版部署 1.不使用最新版，寻找对应纯净版（可选） 打开Minecraft Assets Explorer ``` https://mcasset.cloud/ ``` 选择对应版本后下载对应json文件  搜索关键字 server.jar 就可以找到对应的下载url  在本地下载后，一会儿上传到LightOS内 2.官方最新版： 从官方页面下载 `server.jar`： ```text https://www.minecraft.net/download/server ``` 3.安装server端 创建服务器目录： 这里的$USER替换成创建时的用户 ```bash sudo mkdir -p /opt/minecraft-server sudo chown -R "$USER:$USER" /opt/minecraft-server ```  进入服务器目录： ```bash cd /opt/minecraft-server ``` 本地下载完成后在LightOS内上传附件，选择本地的server.jar文件  上传的文件会存在在/tmp目录，我们先移动过来 ``` mv /tmp/server.jar /opt/minecraft-server ``` 首次启动，生成EULA文件，报错是正常的 ```bash java -Xms2G -Xmx4G -jar server.jar nogui ```  首次启动会生成 `eula.txt`，需要同意 EULA 后才能继续运行： ```bash vi eula.txt ``` 进去之后按i进行编辑 把： ```text eula=false ``` 改成： ```text eula=true ``` 按esc 再输入":wq" 进行保存 保存后再次启动： ```bash java -Xms2G -Xmx4G -jar server.jar nogui ``` 常见配置文件是 `server.properties`，常用项： ```properties server-port=25565 online-mode=true motd=A Minecraft Server difficulty=normal max-players=20 view-distance=10 simulation-distance=10 ``` 说明： - `online-mode=true`：正版验证。公开服建议保持 `true`，要是联机的小伙伴没有正版账户，这里**看情况**进行调整。 - `server-port=25565`：默认端口，不要变，等会儿把端口通过服务的方式映射出去。 - `view-distance` 和 `simulation-distance` 越高越吃性能。 **这里为止已经成功启动服务器了** ### 4、Paper 插件服部署 Paper 是高性能服务端，适合纯净玩法加插件，比如领地、权限、登录、经济、菜单等。多数情况下，玩家客户端不需要安装任何东西，只要版本匹配就能进。 下载地址： ```text https://papermc.io/downloads ``` 下载后和纯净版部署一样，上传到LightOS内，例如： ```bash mv /tmp/paper-*.jar paper.jar cd /opt/minecraft-server java -Xms2G -Xmx4G -jar paper.jar --nogui ``` 插件放到： ```text /opt/minecraft-server/plugins/ ``` 注意：插件服和 MOD 服不是一回事。Paper 插件一般不能直接放进 Fabric/Forge/NeoForge 的 `mods` 目录。 5、安装MOD 1.寻找MOD方式 推荐来源： - Modrinth：[https://modrinth.com](https://modrinth.com) - CurseForge：[https://www.curseforge.com/minecraft](https://www.curseforge.com/minecraft) - MC百科：https://www.mcmod.cn/ - 整合包官方页面提供的 Server Pack 找 MOD 时按这个顺序检查： 1. Minecraft 版本是否一致 例如服务器是 `1.21.1`，就不要下载 `1.20.1` 的 MOD。 2. 加载器是否一致 Fabric MOD 给 Fabric 用，Forge MOD 给 Forge 用，NeoForge MOD 给 NeoForge 用。 3. 运行位置是否正确 有些 MOD 是客户端专用，有些是服务端专用，有些两边都要装。 4. 依赖是否齐全 下载页面通常会写 Required Dependencies。 大型模组通常支持多个不同的加载器，可以按需选择 ![[Pasted image 20260520202310.png]] 如果你要开整合包服务器，优先找它提供的 `Server Pack`。Server Pack 通常已经帮你整理好了服务端需要的 MOD、配置和启动脚本，比自己从客户端包里拆更稳。 2.安装MOD服务器 我这里以neoforge 1.21.1版本为例： 官网下载neoforge[The NeoForged project](https://neoforged.net/)  ```bash #安装JAVA sudo pacman -S curl wget unzip screen tmux vi traceroute sudo pacman -S jdk21-openjdk #把刚刚neoforge官网下载的文件上传LightOS后执行下面步骤 sudo mkdir -p /opt/minecraft-server sudo mv /tmp/neoforge-*-installer.jar /opt/minecraft-server/neoforge.jar #把传到LightOS的文件传到配置好的游戏服务器 sudo java -jar neoforge.jar #安装neoforge ``` 这里服务器需要的组件就安装完成了，接下来执行： ```bash sudo chown -R "$USER:$USER" /opt/minecraft-server #$USER填写LightOS注册时输入的用户 sudo sh /opt/minecraft-server/run.sh ``` 会出现报错：  去调整下eula.txt ```bash sudo vi eula.txt ``` 进去之后按i进行编辑 把： ```text eula=false ``` 改成： ```text eula=true ``` 按esc 再输入":wq" 进行保存 然后添加需要使用的MOD： ```bash #找到MOD后上传到LightOS内 sudo mv /tmp/mod名称 /opt/minecraft-server/mods/ ``` 最后执行： ```bash sh /opt/minecraft-server/run.sh ``` **这里已经成功启动neoforge服务器了**  ## 三、端口转发 由于MC服务器不是通过http连接的，LightOS内的服务转发不可用，可以用别的方式进行转发。 这里有两张方式，想折腾的可以研究第二种 1、把这个实例修改为hosts模式   然后端口就会到微服本地的25565了 2.端口转发 首先确定自己的实例网络配置 ```bash #实例内输入 ip a #查看本机IP地址 traceroute baidu.com ```   如图，我是100.64.0.12 访问外部通过的第二跳IP是169.254.164.200 然后ssh到微服里面查看网络配置（每个人不一定相同，需要酌情更改） ```bash #在微服输入，不是LightOS实例里面,要打开微服的ssh功能 ip a | grep 169.254.164 #这里填写刚刚第二跳IP的前三个 ```  这里需要在微服里添加一条路由，由于实例出来的网段是169.254.164.200/30(200是网段标识，201是网段里的IP)，所以这里在微服里添加一条路由： ```bash ip route add 100.64.0.12 via 169.254.164.201 #ip route add <目标地址或网段> via <网关IP> ``` 现在微服已经可以成功ping通处于nat模式的实例了  配置端口转发： 使用网络端口转发工具 按照下图进行填写  配置完成后就把LightOS内的实例端口转发到微服上了 **至此完成端口转发，可以准备联机了** 四、联机及客户端配置 1、游戏客户端下载 这里建议使用HMCL作为客户端启动工具 [下载 - Hello Minecraft! Launcher](https://hmcl.huangyuhui.net/download/) 下载后双击启动 我这里有账户，没有官方账户的可以选择注册一个离线账户   安装对应游戏版本：   选择服务器对应版本下载：  2、下载懒猫微服客户端 1）给要联机的同学下载一个懒猫微服客户端 [懒猫微服客户端下载](https://lazycat.cloud/download) 2）创建一个没权限的子账户，让同学登录挂着就行。  所有权限全部关闭：  同学登录后挂着，就能连接到你配置的端口转发了。 在联机之前确保： 1）游戏服务器和客户端的版本是相同的。 2）要是装了mod，确保mods目录文件相同。 3）登录游戏，游戏内点击多人游戏-联机域名输入：<自己的微服名称>.heiyu.space:25565,即可成功连接。   也是成功连接上服务器了  测试延迟也是超级快  性能也不需要担心，LightOS是硬件直通的，完全不用担心转译损耗的问题。 

懒猫微服部署 Trivy Web UI 让应用镜像风险一键可见

# 懒猫微服部署 Trivy Web UI 让应用镜像风险一键可见 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.liu.trivy ## Why - 为什么选择 Trivy Web UI？ ### 应用场景 - **应用审核前检查**：在懒猫微服应用商店审核镜像时，先确认是否存在高危漏洞。 - **初次部署体检**：自己准备安装的应用，在安装前或刚部署完成立即扫描。 - **安全敏感自检**：对安全要求较高的用户，定期抽查常用镜像的风险状态。 ### 解决的痛点 - 懒猫应用镜像无法从外网获取，传统 Trivy 无法直接扫描。 - 多人分别在终端执行 Trivy 时，重复下载体积巨大的漏洞数据库。 - 纯命令行操作门槛高，配置差异导致扫描策略不一致。 ### 方案优势 - **内网直连**：部署在懒猫微服内部，可直接访问受保护的商店镜像。 - **可视化体验**：表单化配置、实时日志、结果导出，降低安全工具的入门难度。 - **离线加速**：内置本地漏洞数据库，可通过环境变量自定义镜像源并定期更新。 - **漏洞库复用**：本地命令行可指向服务器漏洞库，避免重复下载资源。 ## What - Trivy 与 Trivy Web UI 是什么？ ### Trivy 的定位 - 轻量级安全扫描器，覆盖容器镜像、文件系统、依赖包、IaC 模板等多种资产。 - 支持 CVE 漏洞、配置合规、敏感信息等多维度检查。 ### Trivy Web UI 的角色 - 部署在懒猫微服上的 Web 管理界面，为 Trivy 提供可视化入口。 - 负责镜像源管理、仓库凭据录入、扫描配置、风险报告导出与历史追踪。 - 通过场景模板固化常用设置，帮助个人快速复用安全检查流程。 ## Who - 谁适合使用？ ### 目标用户 - 懒猫微服应用的审核人员，在审核流程中顺手检查镜像安全。 - 对懒猫微服生态安全特别敏感的个人用户，想在安装前后掌握镜像风险。 - 自行构建或修改镜像、希望在发布前做最后一次安全确认的个人开发者。 ### 前置准备 - 确认已在懒猫微服应用商店安装好 Trivy Web UI。 - 准备好目标镜像所在仓库的访问凭据（如有）。 - 了解自己对漏洞等级的接受阈值，方便设置过滤策略。 ## When - 什么时候使用？ ### 关键时刻 - 将镜像提交到懒猫微服应用商店审核之前。 - 在自己的懒猫微服上首次部署或升级第三方应用时。 - 发现相关镜像有新增漏洞通告、想确认风险程度时。 ### 使用节奏 - 审核和部署环节视为必做步骤，保障第一时间掌握风险。 - 如果对安全格外敏感，可建立自己的周期性扫描计划（如每月或每季度）。 - 当收到安全事件或社区提醒时，及时补扫重点镜像。 ### 扫描结果有效性 - Trivy 官方漏洞库每 6 小时构建更新一次，建议定期重新扫描关键镜像以获取最新风险评估。 - Trivy Web UI 内置的离线漏洞库会随应用更新而刷新，关注应用商店的版本更新提示即可。 - 对于长期运行的生产镜像，建议至少每月重新扫描一次，以发现新披露的漏洞。 ## Where - 在哪里部署与操作？ ### 部署位置 - 懒猫微服务器内置 Trivy 服务与 Web UI，无需额外安装。 -  - 服务监听固定端口（Trivy Server 的 API 端口为 59902）。 ### 可扫描的镜像来源 - 懒猫应用商店镜像（直接读取宿主机缓存）。 -  - 私人或团队自建的镜像仓库。 - 公有仓库：Docker Hub、阿里云容器镜像服务等，只要网络可达即可。 ### 访问终端 - 推荐使用桌面浏览器访问 Web UI，便于查看报告与管理模板。 - 若习惯命令行操作，可在局域网终端通过 Trivy CLI 调用服务器。 ## How - 如何配置与使用？ ### 一、初次登录与界面巡览 - 1. 打开懒猫微服应用入口，访问 Trivy Web UI。 -  - 页面底部会有应用版本号，以及该应用代码仓库的链接。 - 2. 使用平台账号登录，进入“镜像扫描配置”页面。 -  - 3. 熟悉页面布局：顶部为镜像地址与凭据，中部为扫描选项，高级选项与配置管理位于折叠面板，底部展示扫描历史。 -  ### 二、基础扫描配置 1. **指定镜像**：在“镜像地址”栏输入完整地址，或点击“从宿主机选择”读取本地镜像列表。 https://appstore.lazycat.cloud/#/shop/detail/top.j0k3r.lpk-inspector - 1. 你可以通过 懒猫应用查看器，在部署应用前就获取到应用依赖的镜像地址。 -  - 2. 你可以通过应用本身的 从宿主机选择 来获取运行中和本地全量的镜像地址列表。 -  2. **配置凭据**：如目标仓库需认证，填写用户名与密码，可选择启用 TLS 证书校验。 - 1. 如果是扫描 懒猫微服 **原生镜像**（镜像地址前缀是 registry.lazycat.cloud），不需要配置凭据，并且需要取消 `启用 TLS 证书校验 - 1. 如果是其他私有镜像仓库，请配置相关的凭据。 - 3. **安全提示**：默认不保存密码，每次需重新输入。若需保存密码便于重复扫描，可在应用配置中设置环境变量 `TRIVY_ALLOW_PASSWORD_SAVE=true`。建议使用只读权限的凭据以降低风险。 3. **选择扫描选项**： - 漏洞严重等级：限定需要关注的最低等级（默认全部）。 -  - **推荐策略**：生产环境或商店审核建议关注 HIGH 及以上；个人测试环境可只关注 CRITICAL，减少信息过载。 - 检测优先级：切换精准模式以降低误报，或选择速度优先。 -  - 包类型：是仅扫描基础镜像的漏洞，还是仅扫描应用自身的漏洞。 -  - 输出格式：JSON、HTML 等，方便保存记录或与他人分享。 -  - 详细说明请参考 Trivy 官方文档。 4. **配置输出选项**：确认输出格式，并在需要时勾选"只显示有修复方案的漏洞"等过滤项。 -  - 有些漏洞是展示没有修复版本的，如果你不需要看到这部分漏洞，可以勾选后忽略。 ### 三、场景模板管理 1. 展开“高级选项”中的配置管理区域。 -  2. 选择或新建模板名称，将当前配置保存为模板。 3. 典型模板建议： - `registry-review`：懒猫商店审核时使用，严格策略关注 HIGH 及以上漏洞。 - `self-hosted`：个人私有仓库镜像检查，可自定义安全等级。 - `public-registry`：检查 Docker Hub、阿里云等公有仓库的第三方镜像，建议关注 CRITICAL 和 HIGH。 4. 后续扫描时，通过下拉列表快速切换模板，保持自己的检查流程一致。 ### 四、执行扫描与分析结果 - 1. 点击“开始扫描”，系统会立即拉取镜像并运行 Trivy。 -  - 2. 在扫描过程中，可观察页面状态与进度提示，如需排查可打开实时日志。 - 3. 扫描完成后，历史记录区域会列出镜像名称、时间、状态与漏洞统计。 - 4. 点击“查看日志”了解细节，或选择“下载报告”获取离线文件，根据 CVE、风险等级、影响组件判断是否继续使用该镜像或采取替代方案。 -  ### 五、高级选项与调优 1. **调试模式**：勾选后显示更详细的执行日志，用于排错。 -  -  3. **自定义漏洞数据库镜像**：在懒猫微服的应用配置中设置环境变量，指向自备的漏洞库镜像地址。 -  - 示例环境变量配置： ```bash TRIVY_DB_REPOSITORY=ghcr.io/aquasecurity/trivy-db TRIVY_JAVA_DB_REPOSITORY=ghcr.io/aquasecurity/trivy-java-db ``` - 如需使用国内镜像加速或私有镜像源，修改上述地址即可。 3. **输出控制**：切换输出格式或启用调试按钮，便于和自己的记录方式或脚本配合。 ### 六、隐藏技巧：复用服务器漏洞库 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward - 1. 确认懒猫微服的 Trivy 服务端口（默认 59902）对内网可访问。 -  - 2. 在任意终端执行： ``` trivy image --server http://懒猫微服IP:59902 镜像名 ``` -  - 3. CLI 会直接复用懒猫微服上的离线漏洞数据库，减少多台设备重复下载的带宽与存储消耗，同时保证扫描结果与 Web UI 保持一致。 ### 七、常见问题与故障排查 #### 镜像拉取失败 - **现象**：扫描日志显示"unable to pull image"或连接超时。 - **排查步骤**： 1. 检查镜像地址是否正确，确认包含完整的仓库路径（如 `registry.example.com/namespace/image:tag`）。 2. 如需认证，确认用户名和密码无误，并检查是否启用了 TLS 证书校验。 3. 验证懒猫微服的网络连通性，尝试在懒猫微服终端手动 `lzc-docker pull` 该镜像。 4. 对于私有仓库，确认凭据具有拉取权限。 #### 扫描超时或进度卡住 - **现象**：扫描长时间无响应或停留在某个阶段。 - **排查步骤**： 1. 大型镜像（如包含多个操作系统层）可能需要较长时间，建议耐心等待或查看实时日志。 2. 检查懒猫微服的磁盘空间是否充足，Trivy 需要临时存储镜像层。 3. 启用调试模式，查看详细日志定位卡住的具体步骤。 4. 如持续失败，尝试重启 Trivy 服务或重新部署应用。 #### 凭据配置错误 - **典型表现**：提示"authentication failed"或"401 Unauthorized"。 - **解决方法**： 1. 确认用户名和密码中没有特殊字符导致的转义问题。 2. 检查凭据是否已过期或账号是否被锁定。 3. 如使用 Token 认证，确认 Token 格式正确且权限足够。 4. 对于 Docker Hub，确认是否需要使用个人访问令牌（PAT）而非密码。 #### 漏洞数据库更新失败 - **现象**：扫描时提示"database is outdated"或无法连接漏洞库。 - **解决方法**： 1. 检查自定义的 `TRIVY_DB_REPOSITORY` 环境变量是否正确。 2. 确认懒猫微服能访问漏洞库镜像地址（如 ghcr.io）。 3. 如使用离线模式，等待 Trivy Web UI 应用更新以获取最新内置漏洞库。 4. 临时解决：在应用配置中切换到国内镜像加速地址。 ## How Much - 投入成本评估 ### 时间成本 - 首次建立模板与流程约需 5～10 分钟。 - 复用模板后发起扫描，通常 1 分钟内即可完成配置。 ### 资源成本 - 借助懒猫微服内置服务，无需额外服务器或授权费用。 - 内置漏洞库与 CLI 共享机制显著降低网络流量与磁盘占用。 ### 维护成本 - 关注 Trivy Web UI 的应用更新，及时获取最新漏洞库；若使用自定义镜像源，也需偶尔同步版本。 - 不时检查保存的模板和凭据，确保账号仍然可用并符合自己的安全期待。 ## 相关资源 - Trivy 官方文档：https://trivy.dev/latest/ - Trivy 安装指南：https://trivy.dev/latest/getting-started/ ## 结语 通过懒猫微服内置的 Trivy Web UI，你可以在本地网络中高效完成镜像安全扫描：一键套用模板、快速出具报告、复用漏洞库保持一致性。只需几分钟的配置，就能在应用审核或个人部署前做出明智决策，为懒猫微服的日常使用增添一层可靠的安全保障。

用自己的域名实现内外网无缝访问懒猫微服内的应用

# 背景 目前使用懒猫微服已经成功替代我之前的 NAS 成为家庭服务中心了，使用懒猫微服客户端的场景下，默认就是不需要关注内外网，都能够直接访问到我的服务， 但是有一些服务使用第三方，或者原生的客户端，而且本身也有认证功能的情况，就需要一些适配工作， 使用第三方服务自身的认证加上 HTTPS，从而不需要登录懒猫客户端也能无视内外网访问应用。 好在懒猫微服商店的有足够的应用，很大程度的降低的配置的复杂度。 目标效果如下： 1. 无论在家里局域网，还是出门公网，都可以访问服务 2. 使用同一个域名自动适配内外网 3. 使用 HTTPS 加应用自身认证保证安全 # 准备工作 当然，如果想要很方便的访问到内网的服务，还是有一些前置的依赖项的： 1. 自己拥有域名并托管到 cloudflare 上，在此教程中以 example.com 举例 2. 最好的有自己的 ssl 证书，使用 let's encrypt 获取不复杂，在此教程中先默认有证书可用。 补充一句，如果确实没有 ssl 证书，可以考虑使用自签证书。 除了以上依赖，还用到了以下几个应用： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.cloudfalredweb https://appstore.lazycat.cloud/#/shop/detail/app.ikw.lzc.caddy https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 使用 Jellyfin 作为示例： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.jellyfinsingle 然后我们就可以开始配置工作。 # 安装 ## 1. 配置端口转发，打通跨应用访问 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ### 目标服务转发 因为涉及不同的服务进行内外网转发，所以首先我们要将希望转发的服务，通过端口转发工具，转发至微服虚拟网卡，以便转发服务能访问到目标服务。 此处以 Jellyfin 为例，转发 `8096` 端口至 `host.lzcapp:8096`，端口不一定需要一样，不冲突即可。  ### Caddy 局域网内端口转发 由于我们还希望在内网的时候可以方便的访问各种服务，所以需要配置一个 Caddy 局域网端口，作为统一入口。 由于我们需要使用 HTTPS，所以一定需要使用 443 端口。  ## 2. 配置 Cloudflared，打通公网访问 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.cloudfalredweb 参考[官方教程](https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/)，配置 Cloudflared Tunnel 连通域名到懒猫微服的公网访问。 需要注意的是安装 cloudflared 时，直接安装懒猫微服商店中的 Cloudflared 即可。 当连接成功后，选择 `Public Hostname`，  并新增一个自定义子域名，例如 `movie.example.com`，然后保存即可。  此时，你应该已经拥有可以公网直接访问的 Jellyfin 了，而且自带了 HTTPS  ## 3. 配置 Caddy，打通内网访问 通过 Cloudflare Tunnel，我们已经可以通过公网访问 Jellyfin 了，但是我们肯定不希望在家里的时候，也走公网绕一圈，所以我们可以通过 Caddy，实现无缝内网访问。 https://appstore.lazycat.cloud/#/shop/detail/app.ikw.lzc.caddy Caddy 通过配置文件进行转发配置，配置文件位于 Caddy 的应用数据下 `Caddyfile/Caddyfile`， 首先将 ssl 证书也放到 Caddyfile 文件夹下， 然后加入以下内容，最后重启 Caddy 即可： ```Caddyfile movie.example.com { tls /etc/caddy/example.com.crt /etc/caddy/example.com.key reverse_proxy host.lzcapp:8096 } ``` 注意： 1. 第一行是 tls 配置，路径不要写错，`Caddyfile` 文件夹是映射至服务内 `/etc/caddy` 的 2. 第二行是转发配置，`reverse_proxy` 是固定的，域名和端口是前文配置的 ## 4. 路由器配置域名转发 由于域名托管在 Cloudflare，并且进行了 Tunnel 的配置，域名已经默认指向 Cloudflare， 但是我们回到家时，希望直接访问内网，所以需要在路由器上将域名指向懒猫的 IP。 不同的路由器配置方式不同，用户根据自己的路由器配置解析即可。 # 结语 到此，我们完成了所有配置，实现效果如下： 1. 无需启动懒猫微服客户端 2. 公网时，自动通过 Cloudflare Tunnel 访问服务 3. 内网时，自动通过内网访问服务 4. 全程 HTTPS 加密

懒猫微服是我今年发现的一个好工具

趁着节前的不太忙，反馈一下使用的体验，也给有需求的朋友节省点时间。 ### 手机相册同步 买这款产品纯属是个偶然的机会。入了王总的一个语音聊天局，当时对这款产品不是太了解。 只是有一个急迫的需求就是手机图片太多，卡的要换手机。为啥没有同步到iCloud或网盘里， > 原因只有一个：不想手机内容存在网上。 正好听到产品可以解决这一问题：把图片同步到微服，并删掉手机里的照片，照片依旧是完整的并支持Ai搜索。 之前用过同类的苹果的app产品【寻隐】，也是找的Github上开源的一个产品。 > 了解了微服用vpn穿透过去访问，而且只有 **设备名.heiyu.space** 也是访问不过去的。换设备也需要验证码。安全还是不错的吗，胆子又大了些。 既然有Ai搜索，又能自动同步，下单开搞。 先看结果：  同步3万并删掉1万多张照片，也不是一件容易的事。 本着不折腾的原则，能点一下的，绝不能点两下。 本来的想法，不就把大象装冰箱的事吗，门打开 大象放进去 门关上 > 1. 连上内网，手机同wifi > 2. 同步到微服 > 3. 删掉照片 > 仅此而已的事情吗，可是实际搞下来时间有点长 下面是对有同种需求的朋友建议： 1.**同步要晚上同步**，照片感觉是单线程的跑的，一张一张同步的。 我的3万多张，同步了至少10几个小时，硬件是老款的网件路由器的1000M有线接入微服。 2. **删除照片，不能一下选择太多。** 因为苹果手机删除是放到回收站的，还要清除回收站，只能一点点的删除。 > 这里有个技巧：长按拖动是多选，但是往上滚动是不会自动停的，需要注意。 删除这就需要手动了还是需要优化的。 > 优化1：多任务图片上传，能跑多快算多快，再不行插根线直接到微服。 > 优化2：删除照片，提供更多的年 月 日维度。一点就是批量选择，不用老拖动。 >期待团队早日完成 1天半的时间，搞出了大几十个G的空间，手机可以再战一年了也还是**很值得点赞的**。 ### 有了微服了，一点不折腾是不太可能。 ### 那就部署个电影和音乐的服务器 实现的目标： > 1. 电视上可以看电影 > 2. 手机上可以看电影和听歌 实现流程如下： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.embysingle https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 1. 微服上安装emby服务器，开通时需要用户名和密码，这个记住 3. 电视用支持emby协议的播放器加载进来。需要下面的端口映射。默认端口是8096 172.*这个地址是内网地址，选择网卡就能出来。  3.手机上稍微复杂一点，找了好多个播放器。电影都可以搞过来，但是音乐目录不行。最终选择 Filebar。 为啥没有选择emby的手机app，因为这玩意费用大几百，我选择几十的。 注意：手机访问，需要建立个微服域名的的穿透，记着左侧端口不要写：8096。容易冲突。  遗憾的是：carplay没找到好用的工具。 其他好玩的功能，我再玩玩看看。有需求就在商店看看。找不到就问问群里的技术人员。 7*18 服务，我来验证，哈哈 

LightOS实例nat模式端口映射与连接及hclient安装和报错解决

LightOS在使用过程中会需要访问外部服务，可以参考这篇攻略。 使用到的应用： https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.lightos.entry https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 一、端口映射至微服宿主机 简介：可以使用hclient登录后，进行端口转发，如图:  该方式需要安装hclient-cli LightOS在创建新实例的时候可以勾选来进行安装：  在下一步需要勾选"挂载/dev"  若要在已有的实例上使用，则可以通过以下方式： 首先确认是否已安装hclient 在命令行输入: ``` hclient-cli -version ``` 若未安装则提示：  安装方式： 方式一、可以在官网进行下载安装： 官网下载页面：[懒猫微服](https://lazycat.cloud/download) 注：非LightOS设备需确认CPU型号进行下载： 进入官网下载页面获取下载安装包  选择合适的安装平台   ``` #直链下载输入 cd ~ && wget 刚刚复制的内容 sudu chmod +x hclient-cli-linux-amd64 #需要输入当前用户的密码 #后续启动输入 cd ~ && sudo ./hclient-cli-linux-amd64 ``` 方式二、建议使用脚本进行一键安装： ``` curl -fsSL https://gitee.com/aixinyin/scripts/raw/master/fix-hclient-cli.sh | sudo bash ``` 方式一安装的后续输入下面命令启动 ``` cd ~ && sudo ./hclient-cli-linux-amd64 ``` 方式二输入： ``` hclient-cli ``` 进入后首次使用会生成二维码，使用懒猫微服APP扫描即可登录。  也可以使用账号密码登录。 登录后按“q”退出tui界面，后台会存活。 二、连接微服服务 1、直接访问 可以直接调用微服应用提供的服务 通过：<微服名称>.heiyu.space 可以直接访问到微服 通过：<微服应用定义的domain>.<微服名称>.heiyu.space 访问微服应用 2、配置端口转发 可以直接把这个实例内部的TCP、UDP端口转发到微服/任意一台登录了懒猫微服应用的设备上，相反也支持。具体操作如下： 使用端口转发工具：  三、hclient报错解决方案 总结了一下报错，可以根据错误情况来排查。 1.报错Runtime startup failed no such file or directory  解决方法：   2.报错：Runtime startup failed： Failed to connect to user scope bus via local  需要做的事： ``` #查看文件权限 ls -l ~/.config/hportal-client ``` 若有文件为root权限，输入： ``` sudo chown -R <用户名>:<用户名> ~/.config/hportal-client ``` 若有遇到其他问题欢迎评论，看到了会及时更新攻略

局域网端口转发教程

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ## 局域网端口转发访问流程：  > 设备访问——>入口地址——>通过端口转发后——>访问目标地址 > 始终记住访问的永远是左边的地址 > 注意端口范围：**1~65535**（尽量用 **1024** 以上的端口，避免一些常用协议端口，避免转发一些使用过的端口，创建之前一定先检测连通性） ## 配置选项说明以及使用方法 ### 1、微服网卡 (仅微服所在局域网可访问) 限制在微服所在的局域网内访问，外部网络无法直接连接 适用于局域网内部的服务调用和数据传输 **适用使用举例**： 通过微服网卡IP——>访问——>微服应用服务  **通过微服网卡IP——>访问——>微服登录的客户端主机上的服务（目标地址的客户端要登录懒猫微服应用）** 这个可以用远程桌面，访问登录客户端的设备（示例演示的是一个手机上的 `python -m http.server` 的例子）   通过微服网卡IP——>访问——>其他网络地址：微服局域网设备或者微服127.0.0.1的服务（本身127.0.0.1的服务是指：**mainframe** 文件中有 `network_mode：host` 的，或者 **dockge** 部署的容器） 这个可以用远程桌面，微服局域网设备或者微服 `127.0.0.1` 的服务（示例演示 **dockge** 起的服务）   ### 2、微服虚拟网卡 (仅微服应用容器可访问) 适用于微服应用容器内部的通信，外部无法直接访问 提供隔离的网络环境，确保容器间通信的安全性 **懒猫微服平台中的应用默认享有网络隔离，类似Docker容器间隔离。若需两个应用互访，此选项来实现转发配置。** **适用使用举例：** 应用访问——> host.lzcapp:端口 ——>另一个应用服务 [以Radarr和Jackett为例](https://playground.lazycat.cloud/#/guideline/295)  <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/20250605165748091.png?imageSlim" alt="image-20250409140008473" style="zoom: 50%;" /> ### 3、微服域名 (仅登录微服务户端可访问) 通过域名访问，仅限于已登录微服务客户端的用户 提供基于身份验证的访问控制，增强安全性 **适用使用举例**： 登录客户端——>访问：$微服名.heiyu.space:端口——>微服登录的客户端主机上的服务（目标地址的客户端要登录懒猫微服应用） 这个可以用远程桌面，访问登录客户端的设备（示例演示的是一个python的例子）   登录客户端——>访问：$微服名.heiyu.space:端口——>其他网络地址：微服局域网设备或者微服127.0.0.1的服务（本身127.0.0.1的服务是指：mainframe中有network_mode：host的，或者dockge部署的容器） 这个可以用远程桌面，微服局域网设备或者微服 `127.0.0.1` 的服务（示例演示微服局域网的 **Ubuntu** 的 **ssh** 远程）  <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20251118133025952.png?imageSlim" alt="image-20251118133025952" style="zoom:50%;" /> ### 4、微服务户端 (仅映射的客户端本地可访问) 服务仅映射到客户端本地，其他设备或用户无法访问 适用于需要本地化服务的场景，保护数据隐私 这个就相当与把微服应用服务、其他客户端的服务端口、其他地址服务端口，转到某一个设备上面，在那个设备上面使用127.0.0.1即可访问 **适用使用举例：** 登录客户端——>本地客户端访问 `127.0.0.1:端口` ——>微服应用服务、其他客户端的服务端口、其他地址服务端口  <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20251118135613205.png?imageSlim" alt="image-20251118135613205" style="zoom: 50%;" /> ### 5、微服通配地址 (0.0.0.0) 绑定到所有网络接口，允许从任意地址访问 通常用于开放服务的场景，保护数据隐私 这一个配置可以代替以上除了 微服务户端 (仅映射的客户端本地可访问) 的所有配置 ## 目标转发地址 #### 1、微服应用 **操作过程**： 选择应用（映射懒猫已运行的应用服务） 选择服务(mainfest.yml里的service名称) 选择服务协议（默认tcp/udp） 可下拉选择映射的端口 **主要用途**： 应用的服务暴露与访问 **注意事项**： 应用需要running状态，如果启动了应用，但是列表里面没有running，可以点一下刷新 如果不知道转发应用那个端口，可以点击端口旁边的小问号，查看具体服务对应的具体端口   #### 2、微服客户端 **操作过程：** 选择客户端网络地址（主机名称） 选择服务协议（默认tcp/udp） 选择需要映射的端口 （可选）添加备注 **主要用途：** 客户端调试与访问 这个可以用作远程访问，前提是对端设备也登陆了懒猫微服客户端  #### 3、其他网络地址 操作过程： 输入目标网络地址 选择服务协议（默认tcp/udp） 输入需要映射的端口 （可选）添加备注 **主要用途：通用网络转发（如：dockge写127.0.0.1+端口compose里的端口、微服能通信的网络：写IP地址+服务端口）** 一定要测试连通性 可用用作远程访问微服同局域网的设备上的服务 dockge的写法  微服同局域网的写法  ## 添加转发LPK > 0.9.2 新增功能 我们在别的设备部署了服务，想要通过微服的域名访问，可以使用这个功能。  点击**转发LPK**会弹出**创建转发LPK界面** <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325144411014.png?imageSlim" alt="转发本地py程序" style="zoom:50%;" /> - 子域名：打开应用的子域名，列如 {填写的子域名}.{你的盒子名}.heiyu.space - 名称：在控制台的名称 - 图标：在控制台显示的图标 - 上游地址：要转发的服务地址 - 协议可选 http 和 https，选择与转发服务相同的协议 - ip 要转发服务的地址 - 端口 转发服务的端口 - **跳过认证，可以在不登录微服的情况下使用（API类型的服务，推荐勾选这个选项，在发送请求时不需要在添加微服的认证请求头）** - 图标，在启动台展示的应用图片 - Package ID，自动生成不能修改 <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325144838888.png?imageSlim" alt="image-20260325144838888" style="zoom:50%;" /> 点击创建后会自动安装一个应用到启动台里面 <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325145059804.png?imageSlim" alt="image-20260325145059804" style="zoom:33%;" /> 打开后可以看到本地启动的服务，可以通过 <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325145202696.png?imageSlim" alt="image-20260325145202696" style="zoom:33%;" /> ## NetMap LPK > 0.9.2 新增功能 其他设备部署的服务如果不是 web 相关的，就可以使用这个功能，把目标主机的所有服务全部都转发过来，通过域名来访问。 <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325153044263.png?imageSlim" alt="image-20260325153044263" style="zoom:50%;" /> 我这里把我电脑的IP 通过微服转发，点击创建并安装 <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325153208779.png?imageSlim" alt="image-20260325153208779" style="zoom:50%;" /> 安装之后在微服控制台中会出现一个新的图标，打开之后如下图： <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325153326042.png?imageSlim" alt="image-20260325153326042" style="zoom:50%;" /> 我们访问这个 `archlinux.mhwy.heiyu.space` 域名的所有端口，都会被转发到 `192.168.3.225` 这台电脑上面。 <img src="https://lzc-playground-1301583638.cos.ap-chengdu.myqcloud.com/guidelines/1128/image-20260325153616979.png?imageSlim" alt="image-20260325153616979" style="zoom:50%;" /> 我本机开启了 SSH 服务，这里通过域名访问我本机的 ssh 这里可以看到已经访问成功了 > 注意，访问时需要确保端口转发工具创建的 LPK 是在运行的状态，不然是无法访问的。 ## 结语 端口转发玩法性很多，入口地址与目标地址可以有很多种搭配方式，规则保存之前一定要测试连通性

懒猫攻略-如何通过微服远程连接打印机

# 懒猫攻略-如何通过微服远程连接打印机  https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ## 引言 Hello 大家好！想远程打文件但打印机不在身边？别急，这篇攻略带你快速上手 **懒猫微服**，实现远程打印全流程，简单、实用、一次配置，随时打印。 适用对象： 1.经常需要远程办公、但办公设备（如打印机）不在身边的用户 2.需要异地协助打印文件，如为家人、同事远程输出资料的用户 3.中小企业/教培机构，希望通过网络集中管理打印任务的技术人员 4.希望提高打印效率与灵活性的办公人员或IT管理员 希望能够教会大家如何使用以及正确配置！ ## 前置条件 在正式开始远程打印之前，我们需要先完成一些必要的准备工作，确保整个流程顺利进行。以下是使用 **懒猫微服** 实现远程打印所需的前置条件： **打印机** **PS:打印机必须拥有网络能够连接局域网**  **懒猫微服**  **使用懒猫微服远程打印需满足以下条件:** 1. 已安装并登录懒猫微服客户端 2. 本地网络正常，打印机已连接并可正常使用 3. 具备管理员权限，允许设置打印服务映射 4. 被控端（打印机所在设备）已开启并在线 5. 控制端与被控端已建立远程连接关系 ## 实现过程 1.安装并且登录懒猫微服客户端   2.使用局域网端口转发工具进行转发  3.配置打印机端口转发 **PS: 有一些打印机并不是通过9100端口进行工作的 需要大家在网上查询自己打印机的相关端口**  4.添加转发规则（**打印机端口:9100**）  5.测试连接性  6.Windows搜索打印机  7.添加打印机，需要等待片刻弹出我需要的打印机不在列表中。   8.选择使用IP地址或者主机名添加打印机  9.选择TCP/IP设备并且 填写主机名映射的域名 https://shou.heiyu.space:9100 端口名称 https://shou.heiyu.space:9100  10.继续下一步  11.安装打印机驱动设备  12.输入打印机名称  13.选择是否共享打印机  14.打印测试页 查看打印机是否输出  ## 结语 至此，通过本文的步骤，你已经掌握了使用 **懒猫微服** 实现远程连接打印机的完整流程。无论是在家办公，还是异地协助他人打印，掌握这一技能都能大大提升你的工作效率。如果在操作过程中遇到问题，建议检查前置条件或查看常见问题模块，确保每一步都正确无误。 现在，就去试试看吧，轻松开启你的远程打印之路！

如何使用IPTV All-in-One在线观看直播

首先，我们需要用到以下两款应用。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 打开**IPTV All-in-One**应用后，显示“请求成功”，就代表应用运行成功了，就可以关闭窗口了。  然后，我们打开**局域网端口转发工具**，进行下面设置： > - 局域网出口类型：微服物理网卡（仅微服所在局域网可访问） > - 微服物理网卡：懒猫微服IP地址 > - 端口：35455 > - 微服应用：IPTV All-in-One/iptvallinone/tcp/35455 点击测试链接，显示成功就表示可以了，见下图  > 记住你的懒猫IP地址，下面我们就开始找个支持IPTV源的软件配置使用了。 # **注意！注意！注意！使用时请确保播放软件和懒猫盒子是在同一局域网内。** ## 直播源地址配置 这是该应用的官方使用文档：[IPTV All-in-One](https://pan.v1.mk/%E6%AF%8F%E6%9C%9F%E8%A7%86%E9%A2%91%E4%B8%AD%E7%94%A8%E5%88%B0%E7%9A%84%E6%96%87%E4%BB%B6%E5%88%86%E4%BA%AB/allinone%E4%BA%8C%E8%BF%9B%E5%88%B6%E6%96%87%E4%BB%B6/%E4%BD%BF%E7%94%A8%E8%AF%B4%E6%98%8E.md) 网页提供多个直播源设置，我们就以下图四个做个示例：  按照上图中红框地址，对应设置如下： > - BiliBili生活：http://你的懒猫微服IP:35455/bililive.m3u > - 虎牙一起看：http://你的懒猫微服IP:35455/huyayqk.m3u > - 斗鱼一起看：http://你的懒猫微服IP:35455/douyuyqk.m3u > - YY轮播：http://你的懒猫微服IP:35455/yylunbo.m3u ## 桌面端 这里用senplayer进行演示，首先打开应用，点击左侧**IPTV**，然后再点击右侧“**+**”，选择**在线订阅**  在弹出的对话框内填入上面对应设置的地址，然后点击导入：  导入后效果如下：  四个都导入后：  然后我们就可以随机点开其中一个，比如虎牙，可以看到分类和对应的频道数量：  点击“一起看”：  点击“周星星”，或者选择你喜欢的频道点击查看  下图是YY轮播里的测试效果图：  桌面端就测试到这里，剩下的就是自己选择喜欢的进行播放了。 ## 安卓端Android 这里我用[OK影视](https://github.com/FongMi/Release)来进行演示： 打开应用，按照下面步骤进行配置，可见下图： > 1. 点击设置 > 2. 点击直播 > 3. 粘贴上面设置的直播地址，点击确定 > 4. 点击直播窗口  效果如下：  ## TV端 ok影视也有[TV版](https://github.com/FongMi/Release/tree/okjack/apk/release)，选择自己电视支持的版本，下载安装后，配置方式同安卓端一样。 > 如果有些频道显示access denied的话，请切换其他频道观看，或者稍等之后再尝试，有时会受网速和直播源影响，请谅解！ # **最后，祝大家观看直播愉快！！！**

AxonHub -- 给你的小龙猫装上一个AI模型网关

之前用CPA来搭配小龙虾，这次我们换个新的AI模型网关---AxonHub，正好给新晋选手---小龙猫来配置使用。 先打开下面的AxonHub应用链接，在懒猫商店里安装。 https://appstore.lazycat.cloud/#/shop/detail/community.lazycat.app.axonhub 首次打开会有个配置向导，小白不懂的话，直接默认点击下方开始部署即可。  ### 注册账号密码 进入应用后，首先需要创建账号密码，按需对应填写即可，然后点击“初始化系统”。  进入后，填写你创建的账号密码进行登录。  首次进入应用会有个配置向导。如果你想先了解一下这个应用的话，可以点击“开始引导”，跟随它的指引一一了解功能。这里我们就直接点击“跳过引导”，到下一步。  ### 配置AI模型 > 跟CPA一样，需要先配置AI厂商模型。 点击左侧的“渠道”，然后点击页面右上角的“添加渠道”。  在新跳出的窗口可以看到左侧基本上主流的AI服务商都包含在内了，右侧就是每个服务商需要设定的配置信息。  #### 这里我们先配置Deepseek，可参考下图。 1. 左侧选择“Deepseek”渠道 2. 右侧“渠道名称”可自己修改 3. 下方“API Key”填入你的ds官方key 4. 点击“获取”，即可在右侧看到对应可以使用的模型 5. 根据自己的爱好进行配置，点击“确认选中” 6. 需要在默认测试模型中选择一个模型，用于测试API Key是否可行 7. 填写完所有之后就可以点击右下角的“创建”  创建完成之后，我们就可以看到在渠道中新增的DS配置，这时还需要点击打开“状态”， 点击“测试”看连通性，显示“测试成功”后，就可以点击下方的“启用”。这样我们才算真正的把DS接入到AxonHub上。   #### 如果你有算力仓，也可以按照下图来进行配置 1. 左侧选择“OpenAI”渠道（因为算力仓地址兼容OpenAI渠道，可以选这个进行配置） 2. 右侧“渠道名称”可自己修改 3. "Base Url"需要改成算力仓Ollama地址，即“https://ollama-ai.你的设备名.heiyu.space/v1” 4. 下方“API Key”可随意填写 5. 点击“获取”，即可在右侧看到对应可以使用的模型 6. 根据自己的爱好进行配置，点击“确认选中” 7. 需要在默认测试模型中选择一个模型，用于测试API Key是否可行 8. 填写完所有之后就可以点击右下角的“创建”  配置完成之后，还是安装上述再打开“状态”-“测试”-“启用”  #### 如果你购买的是三方API厂商的服务的话，也可以参考下图配置。 流程也是和上述算力仓配置一样，这里就不多赘述了。  到这里，就已经完成了AI服务商的配置并启用了。  ### 配置API Key > 为了能访问使用AxonHub，我们需要先配置API Key。 点击左侧“API密钥”，进入页面后，点击右上角“创建API Key”，在跳出的窗口内，可按需修改名称，类型默认“用户”即可，然后点击“创建”。  创建完之后，我们就可以看到API Key，以及对应的AI客户端的配置示例（如果你正好有用到的话，可以复制这些配置进行替换）。 我们这里需要关注的是这个对外的“Base Url”的填写： 如果你用兼容OpenAI的客户端，填写“https://axonhub.你的设备名.heiyu.space/v1” 如果你用兼容Anthropic的客户端，填写“https://axonhub.你的设备名.heiyu.space/anthropic”  至此，你已经配置好了AI模型和API Key，下一步就是在小龙猫里使用 ## 配置小龙猫并使用 打开下方小龙猫链接并安装 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 新建助手流程就不多说了，这里直接给出AI配置方式，见下图： 1. 点击左侧“AI配置” 2. “供应商名称”可自行填写 3. “AI协议”可选择“OpenAI”，也可选择“Anthropic” 4. “API URL”根据你选择“AI协议”，填写对应的地址，这里我就填写“https://axonhub.你的设备名.heiyu.space/v1” 5. "API Key"填写你在AxonHub里获取的API Key 6. ”模型名称“里，点击下拉箭头选择获取模型 7. 选择你需要的模型 配置好后，点击测试，显示”测试成功“，即表示配置完成了。点击”添加AI供应商“保存配置。  但实际情况是，截止到目前为止，你配置完之后聊天会显示”API call failed after 3 retries: Connection error.“ 连接错误  这时候，你需要用到端口转发工具，对AxonHub进行端口转发配置 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 配置后，只需要对应修改下”API URL“改成你的IP地址，见下图。这时候选择模型进行验证会显示”验证失败“，不用管，点击保存即可。  然后你进行对话，这时候就可以用了。  AxonHub还有个好处就是，你可以在左侧”请求“里，查看到最近一次”请求详情“，方便你进行查看。  主页面你也可以查看AI模型厂商的调用情况，方便你管理多个上游AI模型厂商。