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

**懒猫微服平台中的应用默认享有网络隔离，类似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”会自动弹出列表，在列表中选择需要的分类。   添加完成后点击测试，没有问题后点击保存，按照上面的方法可以添加多个索引。 

Claude Code Viewer 与 Claude Code Router 联动

## 简介 本文演示如何在懒猫微服中同时部署 Claude Code Router 与 Claude Code Viewer，并把 Claude Code 的请求平滑转发到 DeepSeek 等第三方模型。按照下述步骤操作后，就能在浏览器里获得完整的 Claude Code 体验，同时由 Router 统一管理模型、路由和密钥。 ## Claude Code Router https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.claudecoderouter Claude Code Router 是 musistudio 开源的中间层，用来拦截并重写 Claude Code 的 API 请求。它支持为不同场景配置路由规则、在多家模型供应商（OpenRouter、DeepSeek、Ollama、Gemini 等）间自由切换，同时还提供请求/响应转换、`ccr model` CLI 管理以及插件系统，方便你把自定义的推理流程串在一起。 首次打开应用时需要设置 `APIKEY`，默认值是 `123456`。该值会在后续作为 `ANTHROPIC_AUTH_TOKEN`，因此请先确认好再保存。  部署成功后的界面如下，我们将在这里配置供应商和路由：  以 DeepSeek 为例，按照下列步骤添加供应商： 1. 点击「从模板导入」，在列表中选择 `deepseek`，并填入自己的 DeepSeek API Key（`sk-xxx`），若没有可在 [DeepSeek 控制台](https://platform.deepseek.com/api_keys) 申请。  2. 在同一个对话框中向下滚动至「模型转换器」，把 `deepseek-chat` 与 `deepseek-reasoner` 的转换器都设置为 `tooluse`，确保 Claude Code 的工具调用语义能够正确映射。  3. 切换到右侧「路由」面板，选择刚才配置的 DeepSeek 模型作为默认路由。  4. 点击保存后，服务会自动重启，并在容器内监听 `3456` 端口。 ## 端口转发 为了让其他应用访问 Router，需要借助「局域网端口转发工具」。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward 已知 Claude Code Router 运行在容器内的 `3456` 端口，我们可以按下图配置端口转发，把容器端口暴露到 `host.lzcapp`：  - 局域网入口类型可根据自身网络环境选择。 - 配置完成后，其它应用就可以通过 `http://host.lzcapp:3456` 调用 Claude Code Router。 ## Claude Code Viewer https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.claudecodeviewer Claude Code Viewer 由 kimuson 开源，是一个完整的网页版 Claude Code 客户端。它可以启动或恢复会话、实时查看任务输出、查看会话历史、上传文件、执行 Git Diff/Commit/Push，并内置会话调度器与多语言界面，适合远程环境中集中管理 Claude Code 项目。 在懒猫微服中部署 Claude Code Viewer 时，需要把 Router 的地址和密钥传给它：  - `ANTHROPIC_BASE_URL`：填写 `http://host.lzcapp:3456`，即前文转发后的 Claude Code Router 地址，所有 Claude 请求都会先进入 Router。 - `ANTHROPIC_AUTH_TOKEN`：填写部署 Router 时设置的 `APIKEY`，用于鉴权。 部署成功后，可以直接在 Viewer 中创建项目：  完成初始化并点击「设置项目」，即可进入熟悉的 Claude Code 工作台：  至此，Claude Code Viewer 与 Claude Code Router 已成功串联，所有 Claude Code 请求都会通过 Router 路由到 DeepSeek，从而在浏览器中获得稳定、统一的编码体验。

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模型厂商。 

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

# 背景 目前使用懒猫微服已经成功替代我之前的 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 加密

局域网端口转发教程

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 是在运行的状态，不然是无法访问的。 ## 结语 端口转发玩法性很多，入口地址与目标地址可以有很多种搭配方式，规则保存之前一定要测试连通性

给你的 AI 助理加上 To Do 功能：让它真正帮你管任务

让懒猫微服里的“小龙猫”助手，通过 `agenttodo-assistant` 技能，连接到 AgentTODO，然后帮你查看、创建、拆分和更新待办任务。 你可以把它理解成： - AgentTODO 负责保存你的任务。 - 小龙猫负责和你聊天、理解你的需求。 - `agenttodo-assistant` 技能负责告诉小龙猫应该怎么调用 AgentTODO。 ## 0. 准备条件 ### 0.1 需要先安装的应用 请先在懒猫微服中安装并启动下面几个应用。 1. 小龙猫 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.totoro 2. AgentTODO https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.agenttodo 3. 局域网端口转发工具 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward ### 0.2 先在小龙猫中创建一个助手 打开小龙猫后，你需要先完成这些基础配置： 1. 安装或创建一个 Agent。 2. 创建一个助手。 3. 配置好这个助手使用的 AI 模型。 4. 确认可以正常和助手对话。 如果你现在还没有办法正常和小龙猫里的助手聊天，请先把小龙猫的基础配置完成，再继续后面的步骤。  ## 1. 为什么需要端口转发 在懒猫微服里，每个应用都是一个独立的容器。 这意味着： - 小龙猫是一个应用容器。 - AgentTODO 是另一个应用容器。 - 它们虽然都装在同一个懒猫微服里，但并不能直接用 `localhost` 互相访问。 很多新手最容易出错的地方，就是让小龙猫访问： ```text http://localhost:3300 ``` 这通常是不对的。 因为这里的 `localhost` 指的是“小龙猫自己所在的容器”，不是 AgentTODO 所在的容器。 所以我们需要先用“局域网端口转发工具”，把 AgentTODO 的 `3300` 端口转发到微服的物理网卡 IP 上。这样小龙猫助手就可以通过一个局域网地址访问 AgentTODO。 ## 2. 配置 AgentTODO 端口转发 这一部分的目标是得到一个小龙猫可以访问的 AgentTODO 地址，格式类似： ```text http://192.168.1.140:3300 ``` 其中 `192.168.1.140` 要替换成你自己的微服物理网卡 IP。 ### 2.1 打开局域网端口转发工具 在懒猫微服中打开“局域网端口转发工具”，新增一条端口转发规则。  ### 2.2 填写基础信息和入口配置 请按下面方式填写： 1. `备注`：填写 `AgentTODO 端口开放` 2. `协议`：选择 `TCP` 3. `局域网入口类型`：选择 `微服物理网卡` 4. `监听端口 / 端口段`：填写 `3300` 这里最重要的是 `局域网入口类型`。 一定要选择： ```text 微服物理网卡 ``` 这样转发出来的地址才会变成局域网里可以访问的地址。  ### 2.3 填写目标配置 继续填写目标配置： 1. `转发目标类型`：选择 `微服应用` 2. `微服应用`：选择 `AgentTODO` 3. `实例用户`：选择当前 AgentTODO 所在的用户，一般保持默认即可 4. `服务`：选择 `agenttodo` 5. `目标端口`：填写 `3300` 填写完成后，点击 `测试目标连接`。 - 如果测试成功，保存这条规则。 - 如果测试失败，请先看后面的常见问题。  ### 2.4 记住微服物理网卡 IP 保存端口转发规则后，请记住你的微服物理网卡 IP。 比如你的微服物理网卡 IP 是： ```text 192.168.1.140 ``` 那么 AgentTODO 的访问地址就是： ```text http://192.168.1.140:3300 ``` 后面要把这个地址告诉小龙猫助手。 请注意： - 不要写成 `localhost`。 - 不要写成 `127.0.0.1`。 - 不要漏掉前面的 `http://`。 - 不要漏掉后面的端口 `:3300`。  ## 3. 在小龙猫中安装 AgentTODO 技能 这一部分的目标是让小龙猫助手学会怎么使用 AgentTODO。 技能地址是： ```text https://github.com/iHunterDev/agenttodo-assistant ``` ### 3.1 直接让助手安装技能 打开你在小龙猫中创建好的助手，直接发送下面这段话： ```text 请帮我安装这个技能： https://github.com/iHunterDev/agenttodo-assistant ```  ### 3.2 等待技能安装完成 安装完成后，小龙猫应该会告诉你技能已经安装成功，或者可以开始使用这个技能。 如果安装失败，请先确认： - GitHub 地址是否复制完整。 - 小龙猫当前是否可以正常联网。  ## 4. 告诉助手 AgentTODO 地址 技能安装好以后，还需要告诉助手你的 AgentTODO 地址。 假设你前面记下来的微服物理网卡 IP 是： ```text 192.168.1.140 ``` 那么你就对助手发送： ```text My AgentTODO address is http://192.168.1.140:3300 ``` 请把 `192.168.1.23` 换成你自己的微服物理网卡 IP。 发送以后，助手会根据这个地址自动推导出 AgentTODO API 地址： ```text http://192.168.1.140:3300/api ``` 一般情况下，你不需要手动填写 `/api`，只需要告诉助手 AgentTODO 页面地址即可。  ## 5. 测试是否连接成功 现在用一两句话测试一下即可。 ### 5.1 查看今天的任务 对助手发送： ```text 帮我看看今天要做什么。 ``` 如果连接成功，助手会去 AgentTODO 中读取今天的任务，然后再回复你。 如果你今天还没有任务，它可能会告诉你今天没有待办。  ### 5.2 创建一个简单任务 继续测试创建任务： ```text 帮我创建一个任务：明天下午 3 点前提交周报。 ``` 创建完成后，你可以打开 AgentTODO 页面（去应用列表，打开 AgentTODO 这个应用，可以看到当前的任务和管理任务），看任务是否已经出现。   ## 6. 配置完成后可以怎么用 上面的步骤走完以后，基础配置就完成了。 下面这些不是必须操作的流程，只是一些日常使用时可以参考的说法。你可以按自己的习惯直接和助手说。 ### 6.1 查看任务 ```text 今天我有哪些任务？ ``` ```text 帮我看一下最近有哪些还没完成的事情。 ``` ```text 我这周的任务压力大不大？ ``` ### 6.2 创建任务和计划 ```text 帮我添加一个任务：明天下午 3 点前提交周报。 ``` ```text 帮我创建一个学习 Python 的计划，拆成 5 个步骤。 ``` ```text 帮我记录一个每周五下午整理工作台的重复任务。 ``` ### 6.3 记录进展 ```text 我已经写完周报初稿了，帮我记录一下。 ``` ```text Python 学习计划里，环境安装这一步已经完成了。 ``` ```text 搬家计划完成了，帮我把它标记为完成。 ``` ### 6.4 查找任务 ```text 帮我找一下和搬家有关的任务。 ``` ```text 我之前是不是记过一个买显示器的任务？ ``` ## 7. 常见问题 ### 7.1 为什么不能用 `localhost:3300` 因为小龙猫和 AgentTODO 是两个不同的应用容器。 在小龙猫里，`localhost` 指的是小龙猫自己的容器，不是 AgentTODO 的容器。所以小龙猫访问 `localhost:3300` 时，通常找不到 AgentTODO。 正确做法是使用微服物理网卡 IP，例如： ```text http://192.168.1.140:3300 ``` ### 7.2 端口转发测试失败怎么办 建议按下面顺序检查： 1. AgentTODO 是否已经启动。 2. `协议` 是否选择了 `TCP`。 3. `局域网入口类型` 是否选择了 `微服物理网卡`。 4. `监听端口 / 端口段` 是否填写了 `3300`。 5. `转发目标类型` 是否选择了 `微服应用`。 6. `微服应用` 是否选择了 `AgentTODO`。 7. `服务` 是否选择了 `agenttodo`。 8. `目标端口` 是否填写了 `3300`。 如果这些都正确，但仍然失败，可以重启 AgentTODO 后再测试一次。 ### 7.3 助手说无法连接 AgentTODO 优先检查你告诉助手的地址是否正确。 地址应该类似： ```text My AgentTODO address is http://192.168.1.140:3300 ``` 请重点检查： - IP 是否是微服物理网卡 IP。 - 端口是否是 `3300`。 - 前面是否有 `http://`。 - 有没有错误地写成 `localhost` 或 `127.0.0.1`。 ### 7.4 浏览器能打开 AgentTODO，但助手还是访问失败 请确认你是在同一个网络环境下测试。 有时候你的电脑浏览器能打开某个地址，不代表小龙猫所在的容器也一定能访问它。 在本教程的场景中，建议使用“局域网端口转发工具”暴露出来的微服物理网卡地址，也就是： ```text http://微服物理网卡IP:3300 ``` ### 7.5 技能安装失败怎么办 请检查下面几项： 1. 技能地址是否完整： ```text https://github.com/iHunterDev/agenttodo-assistant ``` 2. 小龙猫是否可以正常访问 GitHub。 3. 当前助手是否已经完成 AI 模型配置。 4. 当前助手是否支持安装技能。 如果只是网络问题，可以稍后再试或者使用小猪佩奇（找 VIP 群获取）。 ### 7.6 任务创建了，但内容不是我想要的 你可以直接让助手修改，例如： ```text 把刚才那个搬家计划改得更细一点，每一步都写清楚要做什么。 ``` 或者： ```text 这个任务不要放到下周了，改成这周五之前完成。 ``` 对于比较重要的任务，建议你让助手先列出计划，确认后再创建： ```text 先不要创建任务，先帮我列一个计划，我确认后你再写入 AgentTODO。 ``` ### 7.7 需要把 AgentTODO 暴露到公网吗 不建议。 AgentTODO 技能的默认使用场景是可信局域网。请不要把 AgentTODO 直接暴露到公网，避免不必要的安全风险。 ## 8. 最后确认 如果下面几件事都能完成，就说明配置成功了： 1. 你可以通过 `http://微服物理网卡IP:3300` 打开 AgentTODO。 2. 小龙猫已经安装 `agenttodo-assistant` 技能。 3. 你已经告诉助手 AgentTODO 地址。 4. 助手可以读取今天的任务。 5. 助手可以创建任务、拆分子任务、记录进展。 完成以后，你就可以把小龙猫当成自己的任务助理来用了。

Omnibox配置篇 --- 一站搞定你所有观影需求

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.omnibox 首先打开应用，点击右上角“我的”  在点击右上角“管理”，进入管理员后台  ## 配置采集站资源 点击左侧“**影视站资源**”，点击右侧“**导入/导出**”  点击“**导入**”，点击”**选择文件**“  > 可从这个地址下载json配置（https://quwenjian.cc/#/?code=O8P6N） 选择下载好的json配置文件  点击“**导入JSON文件**”  你就能看到所添加的采集站点，点击全选，然后点击“**批量测速**”  接着你就可以对一些无法链接的资源进行删除或者修改其采集地址。  下图就是你配置之后的搜索效果，可点击首页影视作品，也可以进行搜索  随便点击一个之后就可以在线观看，可以点击右侧进行站点切换  ## 配置网盘资源（可选） ### 配置盘搜站点 点击左侧“盘搜应用”，点击“配置应用地址”  输入盘搜站点地址，可“**全选**“，然后点击“**保存**”即可  相应的资源站点就出来了  > 因pansou站点比较敏感，可以用[fofa](https://en.fofa.info/result?qbase64=cGFuc291)进行关键词搜索即可找到对应公开站点 ### 配置自己的网盘 点击左侧”**网盘授权**“，选择自己常用的网盘类型，点击右侧“**点击配置授权**”  我这边用夸克网盘做演示，点击夸克网盘右侧授权，这里要求输入cookies  浏览器登录你的夸克网盘，F12进入控制台，点击**Network（网络）**，找到左侧的**list**，右侧下拉看到**Cookies**，复制其值即可  回到应用，粘贴复制的值，点击保存即可  显示”**有效授权**“就表示成功了  > 其他网盘都有配置指示，填入相关参数即可 ## 电视直播配置（可选） ### 电视直播配置 点击左侧”**电视直播**“，点击”**添加**“，名称随便填写，地址请自行寻找对应的直播源，图中的地址仅供测试（https://raw.githubusercontent.com/hujingguang/ChinaIPTV/main/cnTV_AutoUpdate.m3u8）  配置后，点击上方”电视“，选择刚才配置的数据源，选择下方频道即可观看。  ### 自定义源 如果你有定制直播源需求的话，可以点击左侧**自定义源**，点击**远程导入**m3u8地址，然后在下方按照示例进行编辑，右侧会显示对应效果。你可以选择导出，再进行上面的添加操作即可重新导入新的直播源。  ### 平台直播 直播间的配置就很简单，选择好对应平台，找到房间号，对应输入信息就可以了 下面以B站直播为例，找到直播房间号  然后回到应用，选择左侧**平台直播**，点击**添加**，对应填写相关信息并保存，见下图  点击上方**直播**，就可以看到刚才添加的直播间  点击即可观看  ### 影视订阅（可选） 这个功能主要是用于一些TVbox，猫影视等空壳软件配置视频源，这样你就有属于自己的影视源，而不需要再去网上寻找了。 我这边以UZ软件为例，点击右上角**影视订阅**，对应复制UZ订阅地址  打开端口转发工具，选择局域网模式，按下图配置 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward  打开UZ软件，设置里点击订阅源，点击+号，把粘贴刚才omnibox里的UZ地址，把前缀懒猫地址替换成你的懒猫IP地址，见下图，点击确定  稍等片刻就可以看到识别之前在omnibox里添加的视频源了。然后对应选择添加导入即可使用。  然后你就可以直接在软件里观看了。   **以上可选部分按自己需求可进行配置，并强制要求，只需配置采集站即可实现基本的观影需求**

利用 OpenVSCode Server 打造远程开发环境

## 简介 OpenVSCode Server 是 VSCode 的浏览器化版本，只需要一个容器即可在任意设备上获得接近桌面版的开发体验。这正好可以把开发环境托管在懒猫微服里，通过浏览器随时接入。 本文围绕懒猫微服给出一套完整的 OpenVSCode Server 部署玩法：从选择合适的镜像、准备项目文件、到构建自定义镜像与端口转发，帮助你把懒猫微服升级成随取随用的远程开发工作站。 ----- ## 版本选择 目前社区比较主流的有两个镜像来源，它们都能在懒猫微服上顺利运行，但侧重点略有差异： - Gitpod 官方镜像：https://github.com/gitpod-io/openvscode-server - 更新节奏快，第一时间同步上游 OpenVSCode Server 的功能与安全修复 - 预装扩展较少，适合作为「白纸」按需扩展；默认容器用户为 `openvscode-server` - 如果你打算完全自定义开发工具链、自己管理依赖，这个版本更容易作为基线 - LinuxServer 社区镜像：https://github.com/linuxserver/docker-openvscode-server - 内建 `linuxserver.io` 家族常见的 `PUID` / `PGID` 权限管理，适合多用户或需要和主机目录共享文件的场景 - 额外提供健康检查、日志目录等默认配置，上手即用但镜像体积略大 - 如果你希望少改动、快速使用并保留 LinuxServer 生态的一致体验，可以选择它 无论选择哪一版，都建议先按文档演练一次原始镜像的部署流程；后续需要扩展开发工具时再基于原镜像构建自定义版本即可。 ----- ## 0. 准备工作 搭建开发环境，详细的步骤请参考官方的开发者手册：https://developer.lazycat.cloud/lzc-cli.html ----- ## 1. 让 OpenVSCode Server 跑起来 先准备三个文件： - `logo.png` 这是应用图标 - `lzc-build.yml` 这是构建时的配置文件，里面只需要简单的写如下内容即可： ```yml pkgout: ./ icon: ./logo.png ``` - `lzc-manifest.yml` 这是最重要的应用设置： ```yml lzc-sdk-version: '0.1' name: MyDevBox package: my.devbox version: 1.103.1 description: My Dev Box application: background_task: true subdomain: devbox routes: - /=http://openvscode_server.my.devbox.lzcapp:3000 services: openvscode_server: image: gitpod/openvscode-server:latest container_name: openvscode_server environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - CONNECTION_TOKEN= #optional - CONNECTION_SECRET= #optional - SUDO_PASSWORD=password #optional - SUDO_PASSWORD_HASH= #optional binds: - /lzcapp/var/config:/config - /lzcapp/var/workspace:/home/workspace ports: - 3000:3000 restart: unless-stopped ``` 然后通过下面的命令把应用安装到懒猫微服中（请确保你的电脑已经连接了懒猫微服）： ```sh lzc-cli project build lzc-cli app install ./my-dev-box-v1.103.1.lpk ``` 运行完成后，我们就可以在应用列表上看到刚才上传的应用了。  注意，应用启动时，会去拉取镜像，如果你所在的网络不幸拉取失败：  可以试试下面的解决方式： ```sh lzc-cli appstore copy-image gitpod/openvscode-server:latest ``` 输入完用户名和密码后它会自动拉取，完成后会给你返回一个懒猫镜像仓库的地址 ``` 登录成功! uploading ... b268dd24: [####################################################################################################] 100% uploaded: registry.lazycat.cloud/scarlex/gitpod/openvscode-server:4ced994585627e2b ``` 我们可以使用这个镜像地址： ```diff services: openvscode-server: - image: gitpod/openvscode-server:latest + image: registry.lazycat.cloud/scarlex/gitpod/openvscode-server:4ced994585627e2b ``` 然后重新运行刚才的 `lzc-cli` 构建和安装应用的命令即可。 当应用成功运行后，我们就能看到 OpenVSCode Server 的界面了：  对于开发者来说，我们经常在终端中运行常用的命令（如 `node`、`pnpm` 等），官方镜像并不会为我们预先安装这些命令：  这时候我们就需要添加自定义的部分了。 ----- ## 2. 自定义开发环境 要在 OpenVSCode Server 中添加自定义的工具，正确的做法是构建自定义镜像。在官方仓库的文档中建议我们通过这种方式去构建镜像： ```dockerfile FROM gitpod/openvscode-server:latest USER root RUN ... USER openvscode-server ``` 先切换成 `root` 用户，然后执行自定义的命令，最后切换会 `openvscode-server` 用户。 这是面向生产环境的建议，作为开发环境，我认为直接使用 `root` 用户会更加方便。 （~~我就是被 `openvscode-server` 的用户权限虐得不行才改用 `root` 的~~） ### 自定义 Docker 镜像 我们先创建一份 `Dockerfile`: ```dockerfile FROM gitpod/openvscode-server:latest USER root # 更新包列表并安装必要的依赖 RUN sed -i "s/deb.debian.org/mirrors.ustc.edu.cn/g" "/etc/apt/sources.list" && \ sed -i "s/archive.ubuntu.com/mirrors.ustc.edu.cn/g" "/etc/apt/sources.list" && \ sed -i "s/security.ubuntu.com/mirrors.ustc.edu.cn/g" "/etc/apt/sources.list" && \ apt-get update && \ curl -fsSL https://deb.nodesource.com/setup_lts.x | bash - && \ apt-get install -y nodejs zsh && \ rm -rf /var/lib/apt/lists/* ENV NPM_HOME="/root/.local/share/npm" ENV PNPM_HOME="/root/.local/share/pnpm" ENV PATH="$PNPM_HOME:$NPM_HOME/bin:$PATH" RUN npm config set prefix $NPM_HOME && \ npm config set registry https://registry.npmmirror.com && \ npm install -g pnpm@latest-10 && \ pnpm config set store-dir $PNPM_HOME/store ``` 这份 `Dockerfile` 包含这些功能： - 改用清华的源，加速 `apt-get` - 安装 `node.js` 和 `pnpm` - 设置缓存目录，方便重用依赖 然后创建一份 `build-docker-image.sh`，把构建命令添加到里面后我们就能方便调试了 ```sh USERNAME="lzc" APPNAME="openvscode-server-devbox" BOXNAME=$(lzc-cli box default) docker build --platform linux/amd64 -t lzc/$APPNAME:latest . --no-cache docker tag $USERNAME/$APPNAME:latest dev.$BOXNAME.heiyu.space/$USERNAME/$APPNAME:latest docker push dev.$BOXNAME.heiyu.space/$USERNAME/$APPNAME:latest ``` 它主要干了两件事： - 构建自定义镜像 - 把构建好的镜像推送到懒猫微服中（注意 `USERNAME` 必须为 `lzc`， `APPNAME` 随意） 为它添加可执行权限并运行： ```sh chmod +x ./build-docker-image.sh ./build-docker-image.sh ``` 运行成功后会看到这样的输出  ### 使用自定义镜像 这时候我们需要修改 `lzc-manifest.yaml` 文件 ```yaml lzc-sdk-version: '0.1' name: DevBox package: my.devbox version: 1.103.1 description: My Dev Box application: background_task: true subdomain: devbox routes: - /=http://openvscode_server.my.devbox.lzcapp:3000 services: openvscode_server: image: dev.<DEVICE>.heiyu.space/lzc/openvscode-server-devbox:latest container_name: openvscode_server environment: - PUID=1000 - PGID=1000 - TZ=Etc/UTC - CONNECTION_TOKEN= #optional - CONNECTION_SECRET= #optional - SUDO_PASSWORD=password #optional - SUDO_PASSWORD_HASH= #optional binds: - /lzcapp/var/config:/config - /lzcapp/var/workspace:/home/workspace - /lzcapp/var/pnpm-store:/root/.local/share/pnpm/store user: root restart: unless-stopped ``` 注意两个地方： - `image` 改成 `dev.$BOXNAME.heiyu.space/$USERNAME/$APPNAME:latest` 的值 - `user` 改成 `root` 然后运行刚才的安装脚本 ```sh lzc-cli project build lzc-cli app install ./my-dev-box-v1.103.1.lpk ``` 打开懒猫微服中的 DevBox  我们刚才的改动生效了。 试试使用 pnpm 创建项目并运行一下：  我们启动了 vite 服务器，暴露了 5173 端口，这时候通过浏览器域名访问该端口  这时候是无法从外部访问的。 ### 3. 局域网端口转发 #### 让开发服务器允许被外部访问 默认情况下，vite 的开发服务器只能在 `localhost` 下访问，而它运行在 OpenVSCode Server 容器内，外部是无法访问的。 我们需要在 openvscode-server 里面修改一下 `vite.config.ts` 的配置 ```ts import { defineConfig } from 'vite' import vue from '@vitejs/plugin-vue' // https://vite.dev/config/ export default defineConfig({ plugins: [vue()], server: { host: '0.0.0.0', port: 5173, allowedHosts: ['微服名.heiyu.space'], } }) ``` 这样才能在外部访问 vite 的开发服务器。其中 `allowedHosts` 我们等一会会使用到这个被允许的域名。 修改完成后，使用 `pnpm dev` 启动开发服务器。 #### 进行局域网端口转发 我们需要使用 「局域网端口转发工具」把宿主机的端口转发到应用内部的端口中。 https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward  按照上图中的配置，配置后点击「测试连接」按钮，如果成功转发的话就会有成功的提示。 转发成功后，我们就可以在浏览器中 `http://<微服域名>:<端口号>` 的方式访问该项目的开发服务器了！  注意，此处我们需要使用 `http` 协议才能正常访问。 ## 结语 通过上面的案例，我们可以实现一个远程开发环境的搭建，后续的玩法就留给大家发挥了。 Happy Coding ！

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

苦于各类云服务器好一点的配置/流畅的带宽任何一项加一点都很贵，并且到期时要是忘记把数据拿到本地，就会永久丢失了，于是这一篇攻略就出来了。不止配置我的世界服务器，很多类似的服务部署都可以参考这一篇懒猫的网络配置方案。 使用到的应用： 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是硬件直通的，完全不用担心转译损耗的问题。 

品牌共享资料下载站的搭建

## 需求背景：在电商多平台需要开店或上传产品，把资料传递给经销商或内部人员经常要多次发送。如果放在百度网盘等还会因为平台审核自动删除一些图片或文件；需要快速的对内、对外分享品牌的一些资料、产品的宝贝详情图片给经销商，实现7*24小时随时下载； ## ## 需求实现：1、微猫微服硬件一台；2、安装cloudflared、局域网端口转发工具、Alist纯净版三款微猫微服软件；3、公网域名1个； ## https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.cloudfalredweb https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.forward https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.alistlegacy  实现过程： 1、注册cloudflard并登录 1、登录CloudFlare 在微服上打开应用商店——>下载CloudFlared并打开——>点击右上角切换语言“ 中文简体”——>点 击底部“ZeroTrust仪表盘” 这里会出现CloudFlare的登录页面——>点击右上角切换语言“ 中文简体”——>这里有CloudFlare账 号就登录，没有需要注册一个 登录后选择一个账户 这里CloudFlare会让您搞一个团队名称，这里我是直接点击右上角“取 消并退出”——>回到仪表盘主页 2、域名托管 1、托管域名配置 在仪表盘中输入您事先准备好的域名——>点击继续 继续前往激活——>继续 在“将您当前的名称服务器替换为 Cloudflare 名称服务器” 中的B项中的两个域名复制一下（备用） 回到您注册域名的平台，找到域名管理界面——>修改注册资料——>把DNS服务器换成上一步复制 的域名——>确定提交 2、等待生效 更换之后请耐心等待生效时，各个域名平台检测时效性不同。实测阿里云域名2分钟左右。 3、托管完成 点击“概况”页面刷新后，出现“好消息！ Cloudflare 正在保护您的站点”就证明托管成功了 3、配置转发 1、微服关联Cloudflare 1、创建隧道 在Cloudflare账户主页侧边导航栏打开“Zero Trust” 点击“ 网络”——>Tunnel——>创建隧道 隧道类型选择“Cloudflared” 为隧道命名——>保存隧道 2、连接隧道 . 选择Debin——>复制左边“如果您的计算机上已安装 cloudflared：” 内容 粘贴到微服的cloudflard窗口，点击保存——>启动 再次点击侧边导航栏“Tunnel”可以看出隧道连接状态正常 #### 因为随时会更新，如图文不一致，Cloudflare配置请参考：https://github.com/wlabby-1/cloudflared-helper 2、配置应用转发 1、配置转发 打开微服——>下载“局域网端口转发工具”应用“——>打开——>添加映射规则——>开始填写 注意事项： 左侧： 局域网出口类型：选择“微服虚拟网卡（仅微服应用容器内可访问） ℽ 微服虚拟网卡： “ host .lzcapp ” 端口：尽量与需要映射的端口一致 右侧： 转发目标类型：微服应用 微服应用：选择需要映射的应用（这一有个注意点：这个下拉应用选项中需要选Running的）server tcp 端 口（这三个根据自身服务来） 添加完成之后点击“测速连接”确保能正常——>创建  注意：目标转发地址TCP的商品是系统自动出来的，不需要你手工填写！！ 配置转发域名 1、添加公共主机名 . 回到cloudfalre的web页面——>点击隧道后面的“配置”  点击”公共主机名“——>添加公共主机名  2、公共主机名配置 子域：可以自定义（一般写转发的应用名称） 域：下拉复选需要的域名 类型：HTTP URL:host.lzcapp:需要转发的应用服务端口 最后保存主机名  4、测试访问 . 在浏览器输入你的网址，都能正常访问了 5、其它 如果需要指定共享目录，需要在alist管理中设置-存储-把挂载路径和根文件夹路径修改为你想要共享的文件夹就好。