COCO Downloader是一款基于Next.js 16框架构建的现代化音乐搜索与下载平台。其界面设计简约而纯净，支持多渠道音乐搜索、在线试听、批量下载等功能，并配备了流畅的暗黑模式，带有独特的涟漪过渡动画效果。

平台的核心特性包括：

• 🎵 多源聚合搜索：支持全网音乐资源的聚合搜索，内置多种音乐源渠道，用户可以一键切换不同来源。
• 🎧 在线试听：内置精美的悬浮播放器，支持播放与暂停、进度拖拽调节、音量控制以及上下曲目切换操作。
• 🖱️ 便捷交互：优化了列表双击播放功能，鼠标悬停和选中效果经过精心设计，确保操作过程流畅自然。
• ⬇️ 批量下载：支持多选歌曲功能，可以一键批量打包下载所选中的音乐文件。
• 🌓 极致主题体验：
  • 完美适配深色与浅色模式。
  • 采用独家定制的涟漪扩散切换动画，基于View Transitions API实现，视觉效果十分惊艳。
• ⚡ 现代化技术栈：平台基于React 19、Next.js 16 App Router以及Tailwind CSS v4等前沿技术构建。

在线演示站点访问地址为：https://cocodownloader.markqq.com

安装步骤：通过Docker Compose快速部署

使用Docker Compose可以简化部署过程，配置文件示例如下：

services:  
  coco-downloader:  
    image: markcxx/coco-downloader:latest  
    container_name: coco-downloader  
    ports:  
      - 3000:3000  
    restart: unless-stopped

使用教程：界面操作与功能详解

部署完成后，在浏览器中输入 http://NAS的IP:3000 即可访问平台界面。

用户可以通过点击右上角的切换按钮，将界面调整为深色模式，以获得更舒适的视觉体验。

平台已经内置了多个音乐源渠道，确保搜索资源的多样性和覆盖范围。

支持全网聚合搜索功能，用户可以快速找到所需的音乐内容。

平台还支持批量下载音乐，操作简单高效。

下载的音乐文件为MP3格式，文件大小通常在3MB以上，音质为非无损级别，且不包含封面和歌词信息。

总结与评价：COCO音乐站的优缺点分析

对于有音乐下载需求的用户而言，部署COCO音乐站可以方便地获取喜爱的歌曲。用户直接通过浏览器即可搜索并下载音乐，界面设计美观，无广告干扰，并且支持暗黑模式以适应不同环境。然而，平台也存在一些不足，例如若部署在NAS设备上，音乐文件无法直接保存到NAS本地存储中，但作为提供下载服务的工具，其便捷性仍然值得肯定。

总体推荐度：三颗星（下载过程便捷，无广告干扰） 使用体验评价：三颗星（界面简洁明了，操作简单直观） 部署难度评级：一颗星（部署步骤极为简单）

CoPAW是一款能够在本地部署的AI智能体，它具备自主操作电脑的能力，支持长期记忆存储，并可以通过多种平台进行接入。这款工具就像一个私人专属助手，能够帮助用户自动化完成各种日常或复杂的任务，提升工作效率。

其核心功能主要包括以下几个方面：

• 多通道对话支持：可以轻松接入钉钉、飞书、QQ、Discord以及iMessage等多个主流通讯平台，实现跨渠道的智能对话交互。
• 定时任务执行：根据用户预先设定的配置，自动在指定时间运行特定任务，实现自动化管理。
• 可扩展的技能系统：其功能由丰富的Skills技能库决定，拥有近乎无限的可能性。系统内置了诸如定时任务管理、PDF与表单处理、Word/Excel/PPT文档编辑、新闻自动摘要以及文件内容阅读等多种技能。用户还可以根据自身需求，在Skills框架内进行自定义功能的扩展开发。
• 数据本地化存储：所有运行数据和用户信息均存储在本地设备中，不依赖于任何第三方云服务托管，有效保障了数据隐私和安全。

详细安装步骤

本教程演示了在飞牛NAS系统环境中直接部署CoPAW的过程。部署前提是需要具备Python运行环境（要求Python版本大于等于3.10且小于等于3.13）。直接在宿主机系统上安装的优势在于可以获得更高的操作权限，便于执行诸如查看系统实时状态、排查运行问题或自动部署Docker容器等进阶操作。不过，这种方式也可能因操作不当而影响系统稳定性，并且需要用户自行承担相应的安全风险管理责任。

首先，使用SSH客户端工具连接到您的NAS设备。

建议切换至root用户权限，以避免后续安装或运行过程中可能出现的权限不足问题。

sudo -i

首先，检查系统中是否已经安装了符合版本要求的Python环境。

python --version  
python3 --version

提示：如果系统尚未安装Python环境，可以参考以下命令进行安装。

Ubuntu/Debian系  
# 更新软件包列表  
sudo apt update  
  
# 安装Python3  
sudo apt install python3  
  
CentOS/RHEL系  
# 启用EPEL仓库  
sudo yum install epel-release  # CentOS7  
sudo dnf install epel-release  # CentOS8  
  
# 安装Python3  
sudo yum install python3       # CentOS7  
sudo dnf install python3       # CentOS 8

如图所示，系统中已经存在Python3，并且其版本号满足运行要求（介于3.10与3.13之间）。

为了隔离项目依赖，防止影响系统自带的Python环境，需要先创建一个独立的虚拟环境并激活它。

python3 -m venv .venv  
source .venv/bin/activate

CoPaw是一款可部署在本地环境的个人AI助理产品。

核心功能亮点：

• 多平台对话集成：支持通过钉钉、飞书、QQ、Discord、iMessage等多种常用通讯渠道与你进行交互。
• 自动化定时任务：能够根据用户预设的配置，自动执行各类计划任务。
• 模块化技能扩展：其能力由丰富的Skills（技能）决定，具备无限潜力。产品内置了定时任务、PDF与表单处理、Office文档（Word/Excel/PPT）操作、新闻摘要、文件阅读等多种实用技能，并允许用户通过Skills机制进行自定义功能扩展。
• 数据本地化存储：所有数据均存储于用户本地，无需依赖任何第三方云托管服务，保障了数据隐私与安全。

部署方式选择建议： 若你需要实现调用系统底层资源、自动化环境配置或部署复杂应用等高级功能，建议将CoPaw直接安装到操作系统底层。如果主要需求是作为日常AI助理，用于资料整理、信息通知等基础场景，那么采用Docker容器化部署方案会更加简便、灵活且安全。

Docker Compose快速安装

以下是使用Docker Compose部署CoPaw的服务配置示例：

services:
  copaw:
    image: agentscope/copaw:latest
    container_name: copaw
    ports:
      - 8088:8088
    volumes:
      - ./working:/app/working
    restart: always

关键参数说明（更多配置选项请参考官方文档）：

• /app/working（容器内路径）：此目录用于存放CoPaw的配置文件与运行时产生的工作文件。通过卷挂载（volumes）将本地目录./working与之关联，可实现配置持久化与数据管理。

配置与实战操作

1. 访问管理界面：在浏览器地址栏中输入 http://你的NAS或服务器IP:8088，即可访问CoPaw的Web管理界面。

2. 切换中文界面：进入界面后，可点击右上角选项将语言切换为中文，方便后续操作。

3. 配置AI模型：首先进入“模型配置”页面。CoPaw支持连接本地部署的Ollama模型以及各类云端大模型API。 提示：本文示例使用硅基流动的API服务，你可通过其平台注册并获取API Key。 点击“添加提供商”后，再点击“设置”，填入你从模型服务商处获得的API Key即可。 建议添加几个常用或计划使用的模型。 若追求更强的理解与生成能力，推荐选择参数规模较大的模型，例如最新推出的GLM-5系列模型（如Pro版本）。

4. 基础对话测试：返回聊天主页面，发送一条测试消息，验证模型是否已成功连接并能够正常回复。 收到连贯、合理的回复即表明模型调用配置无误。

5. 对接通讯频道：核心功能之一是将CoPaw接入日常使用的通讯工具。官方提供了详细文档指导如何配置钉钉、飞书、QQ、Discord等频道，配置成功后即可直接在这些App内向CoPaw发送指令。 提示：具体对接步骤可查阅官方文档：https://copaw.agentscope.io/docs/channels

6. 管理对话与任务：所有通过Web界面或接入频道的对话记录，均可在“会话”页面中统一查看与管理。 提示：定时任务通常可通过自然语言对话指令自动创建，例如直接告诉CoPaw“每天上午9点提醒我开会”。 当然，用户也可以在“定时任务”页面中手动创建和管理复杂的计划任务。

7. 使用工作区与技能：在“工作区”页面，理论上可以管理CoPaw生成和处理的文件。注意：在当前Docker部署的某些版本中，可能存在一个已知BUG，即界面无法正确识别通过卷挂载映射的本地工作目录中的文件（即使已尝试修改文件权限或为容器赋予最高权限）。不过，在宿主机对应的挂载文件夹内，通常能看到生成的文件实际已存在。 在“技能”页面，则可以查看和管理CoPaw所有内置及自定义的Skills，涵盖了定时任务、文档处理、信息摘要等丰富功能。

体验总结与优缺点分析

本文是第二篇关于CoPaw的实践教程。与直接安装在系统底层相比，采用Docker部署方式在功能权限上可能有一定局限，但其在部署的灵活性、隔离性和管理简便性上优势明显。CoPaw的版本迭代迅速，已从早期的0.0.1版本更新至目前的0.0.5版本。

相较于其他同类工具（如OpenClaw），CoPaw的主要优势在于：

1. 操作门槛低：界面直观，配置流程清晰，易于新手快速上手。
2. 模型兼容性好：支持标准OpenAI API接口，用户可自由选择并灵活切换不同的模型服务提供商。
3. 本地化集成度高：原生支持钉钉、飞书、QQ等国内主流办公通讯软件，更贴合国内用户的使用环境。

当前存在的问题： 在体验Docker版本时，遇到的最主要问题是工作区文件识别BUG，这可能导致通过Web界面管理文件时遇到障碍。根据社区反馈（如GitHub上的相关Issue），该问题已被识别，预计会在后续版本中得到修复。

综合评价：

• 综合推荐指数：⭐⭐⭐⭐（一款表现不错、尤其适合国内用户的本地化AI助理解决方案）
• 使用体验指数：⭐⭐⭐⭐（功能实用，交互简单，易于融入工作流）
• 部署难易指数：⭐⭐（基于Docker的部署过程较为简单直接）

近期，不少用户对论坛部署工具表现出兴趣。在众多选项中，NodeBB因其现代化特性和Docker友好性脱颖而出。以一个实际场景为例，有用户曾使用Discuz!搭建论坛来管理专业资料，但Discuz!的Docker支持有限，因此转向了NodeBB，体验后感觉颇佳。

经过实际测试，NodeBB提供了良好的部署体验和丰富的功能，值得推荐给需要自建社区的用户。

NodeBB论坛平台简介

完整项目名为nodebb/nodebb，可通过GitHub搜索获取详细信息。NodeBB是一个基于Node.js构建的现代化论坛与社区平台，它支持实时消息交互、实时通知、移动端响应式访问，同时提供完整的REST API和插件扩展机制。该平台在保留传统论坛分区与主题讨论结构的基础上，引入了更符合现代互联网产品体验的实时讨论和社交化功能，适合用于搭建用户社区、产品支持论坛、企业内部讨论区及技术交流平台。作为开源项目，NodeBB支持Redis、MongoDB和PostgreSQL等多种数据库，并具备优秀的二次开发与企业定制能力。

使用Docker Compose部署NodeBB

以下以威联通NAS为例，展示如何使用Docker Compose部署NodeBB。虽然官方推荐使用MongoDB，但考虑到论坛类应用的常见需求，本文选择PostgreSQL作为数据库，这通常更直观且易于管理。部署代码如下：

services:  
  nodebb:  
    image: ghcr.io/nodebb/nodebb:latest  
    container_name: nodebb  
    restart: always  
    depends_on:  
      - postgres  
    ports:  
      - "4567:4567" # 请根据实际情况更改端口号  
    volumes:  
      - /share/Container/nodebb/.docker/public/uploads:/usr/src/app/public/uploads  
      - /share/Container/nodebb/.docker/config:/opt/config  
      # 此处可挂载setup.json预设文件，本文选择通过网页安装手动配置数据库  
    environment:  
      TZ: Asia/Shanghai  

  postgres:  
    image: postgres:18.3-alpine  
    container_name: nodebb-postgres  
    restart: always  
    environment:  
      POSTGRES_USER: nodebb  
      POSTGRES_PASSWORD: nodebb  
      POSTGRES_DB: nodebb  
    volumes:  
      - /share/Container/nodebb/.docker/database/postgresql/data:/var/lib/postgresql/data  

  redis:  
    image: redis:8.6.1-alpine  
    container_name: nodebb-redis  
    restart: always  
    command: ["redis-server", "--appendonly", "yes", "--loglevel", "warning"]  
    volumes:  
      - /share/Container/nodebb/.docker/database/redis:/data  
    profiles:  
      - redis

在威联通的Container Station中创建新的应用程序，粘贴上述代码以启动服务。

OGame Vue TS是一款基于现代Web技术构建的单机太空策略游戏，其设计灵感来源于经典的OGame系列。玩家可以在浏览器中直接运行游戏，无需安装额外软件，即可体验在浩瀚银河中建立专属帝国、研发先进科技、建造强大舰队并参与史诗级太空战斗的完整流程。游戏采用响应式设计，确保操作流畅，所有数据经过加密后存储在本地浏览器中，提供了高度私密和便捷的游戏环境。

游戏核心功能一览

游戏集成了丰富的策略管理元素，以下为核心功能特性概述：

• 建筑管理系统 - 允许玩家在行星与月球表面建造并升级多种功能建筑，逐步扩展帝国基础设施。
• 科技研究体系 - 通过解锁和研发各类先进科技，持续增强帝国的综合实力与特殊能力。
• 舰队指挥中心 - 提供舰船的建造、任务派遣以及参与战术性太空战斗的全套管理功能。
• 行星防御网络 - 可部署多种防御设施，有效保护殖民地免受外部威胁。
• 军官招募机制 - 招募拥有独特技能的军官，为帝国发展提供额外的战略加成。
• 战斗模拟工具 - 在投入实际资源前，预先模拟和测试各种战斗场景与结果。
• 银河探索视图 - 直观展示宇宙星图，便于玩家探索并与其他星球进行交互。
• 本地数据持久化 - 所有游戏进度数据均经过加密，安全存储于浏览器本地存储中。
• 主题切换选项 - 支持深色与浅色视觉主题，可根据个人喜好自由选择。
• 多任务队列管理 - 允许玩家同时管理多个建筑建造与科技研究队列，提升效率。
• 月球生成逻辑 - 基于特定概率，可从太空残骸场中随机生成月球，增加游戏变数。

使用Docker Compose快速安装

通过Docker Compose可以便捷地部署游戏服务，以下为详细的配置代码：

services:  
  ogame:  
    image: ghcr.io/setube/ogame-vue-ts:latest  
    container_name: ogame  
    ports:  
      - 8080:80  
    restart: always

游戏启动与界面操作指南

部署完成后，在浏览器地址栏输入 http://您的NAS的IP地址:8080 即可访问游戏主界面。

游戏界面设计简洁清新，初次进入后点击中央的“开始游戏”按钮即可。

阅读游戏相关条款后，勾选确认框并点击“同意并开始”按钮，正式进入游戏世界。

首先呈现的是帝国总览界面，这里集中显示了金属、晶体、重氢等各类资源的实时储量与产量信息。

游戏初期，首要任务是建造基础能源设施“太阳能电站”，以确保后续建筑的电力供应。

点击界面右侧的任务栏，可以清晰查看当前正在进行中的建造、研究等任务列表及其剩余时间。

完成基础建设后，玩家可以着手建造或升级其他建筑。需要注意的是，许多高级项目的解锁依赖于特定前置建筑的等级。

游戏界面顶部会实时显示各类资源每小时的采集效率，帮助玩家精准规划发展策略。

时至今日，微信公众号依然是许多人无法绕过的核心信息来源。

相信不少读者与我有着相似的经历：随手关注，订阅列表便轻松突破百位数。遇到一篇优质或实用的文章，往往只是习惯性地转发或点击收藏，随后便任由其沉寂在信息流中，逐渐被时间掩埋。日积月累，无论是技术干货、行业分析，还是长期追踪的专栏内容，都会面临一个共同困境：文章散落在平台内部，难以进行系统化的本地保存，更不用说高效的检索与二次利用。

当某天真正需要引用或回顾时，常常绞尽脑汁也想不起当初是在哪个公众号看到的。许多优质创作者的文章，其内容与编排本身就能构成一个强大的个人知识库。本文将详细介绍一款开源工具——wechat-article-exporter，它支持通过 Docker 进行私有化部署，也能便捷地托管于 Cloudflare，助你高效备份与管理公众号内容。

工具简介

项目的完整名称是 wechat-article/wechat-article-exporter，你可以在 GitHub 上搜索找到它。

这是一个在线的微信公众号文章批量下载与导出工具，能够抓取文章的阅读量、点赞数、评论等数据。你既可以直接使用其在线服务（详见项目主页），也支持通过 Docker 在本地或私有服务器上部署，或者选择部署在 Cloudflare Workers 上。该工具支持导出多种文件格式，其中 HTML 格式完美打包了图片与样式文件，能够 100% 还原文章在微信中的原始排版与视觉效果。

核心功能特性

• 公众号搜索：支持通过关键词搜索目标公众号。
• 多格式导出：支持导出 HTML、JSON、Excel、TXT、Markdown 以及 DOCX 格式。HTML 格式可完整保留图文样式。
• 数据缓存：对文章列表数据进行缓存，有效减少对微信接口的请求频率。
• 高级过滤：支持根据作者、标题、发布时间、原创标识、所属合集等多个维度对文章进行筛选。
• 合集下载：支持一次性下载公众号内的特定文章合集。
• 多媒体支持：能够处理文章内的图片与视频分享消息。
• 数据导出：支持导出文章的评论（含回复）、阅读量、点赞量、转发量等交互数据。
• 灵活部署：提供 Docker 镜像与 Cloudflare Workers 部署方案。
• 开放 API：工具提供 API 接口，便于与其他系统集成或进行二次开发。

详细部署流程

我们以在威联通（QNAP）NAS 上使用 Docker Compose 部署为例，演示具体的操作步骤。

以下是用于部署的 Docker Compose 配置文件代码：

services:
  wechat-article-exporter:
    image: ghcr.io/wechat-article/wechat-article-exporter:latest
    container_name: wechat-article-exporter
    ports:
      - "3006:3000"
    volumes:
      - /share/Container/article/data:/app/.data
    restart: always

操作时，只需打开威联通 NAS 的 Container Station 应用，创建一个新的应用程序，并将上述配置粘贴进去即可。

本文将快速分享一个游戏资源集合，包含80款H5小游戏，能够通过Docker一键部署到NAS或VPS服务器上。这些游戏覆盖多种类型，为玩家提供便捷的本地化娱乐体验。

游戏列表中包含众多经典作品，例如植物大战僵尸、捕鱼达人、消消乐、斗地主、熊出没主题游戏、飞机大战以及象棋等。这些游戏基于H5技术开发，适合在网页浏览器中直接运行。

就实际体验而言，游戏效果整体尚可接受。部分游戏经过良好优化，运行流畅；但也有一些游戏在性能或界面上表现较为普通，存在改进空间。

详细部署教程

以下以威联通NAS为例，通过Docker Compose配置文件实现快速部署。部署过程简单明了，适合初学者操作。

部署代码如下所示，用户可直接复制使用：

services:  80h5-game:                            container_name: 80h5                image: ghcr.io/liangminmx/80h5:latest      restart: always                      ports:      - "9981:3080/tcp"              # 游戏访问端口      - "9982:80/tcp"                 environment:      # 以下环境变量用于 NGINX 构建或运行时配置      NGINX_VERSION: "1.27.4"      PKG_RELEASE: "1"      DYNPKG_RELEASE: "1"      NJS_VERSION: "0.8.9"      NJS_RELEASE: "1"    privileged: true                 # 赋予特权模式（允许容器执行低级系统操作）    entrypoint:      - /usr/sbin/nginx              # 大多数容器镜像是以 NGINX 启动为主进程      - "-g"      - "daemon off;"                # 让 NGINX 在前台运行（Docker 容器需要）

打开威联通NAS的Container Station应用，创建新的应用程序并将上述代码粘贴到配置区域。

游戏界面与玩法

部署完成后，在浏览器中输入NAS的IP地址加上端口9981，即可访问游戏服务界面。例如，如果NAS IP为192.168.1.100，则访问地址为192.168.1.100:9981。

所有游戏内容均以列表形式展示，用户可点击图标直接开始游玩。需要注意的是，由于游戏设计针对大屏幕优化，建议主要在个人电脑上体验以获得最佳效果。

Cloudreve 是一款基于开源技术的自托管云存储与文件管理解决方案，专注于提供对多种云存储服务的集成支持。它能够实现文件上传、下载、组织管理和分享的一站式操作，采用 Go 语言与 React 前端框架构建，具备即装即用的便捷性和全面丰富的功能特性。

为配合 Cloudreve 私有云盘服务，官方提供了 Windows 桌面同步客户端以及 iOS/iPadOS 移动端应用。此外，社区还开发了适配 Android、Linux、macOS 等平台的第三方客户端，进一步扩展了其跨平台使用能力。

核心功能特性：

• ☁️ 多元化存储后端：支持本地存储、从机节点，并兼容七牛 Kodo、阿里云 OSS、腾讯云 COS、华为云 OBS、金山云 KS3、又拍云、OneDrive（包括世纪互联版本）以及 S3 兼容协议等多种云存储服务。
• 📤 高效传输管理：上传与下载过程支持客户端直传模式，可对下载速度进行限速控制，有效管理带宽资源。
• 💾 离线下载集成：能够与 Aria2 或 qBittorrent 等工具对接实现离线下载任务，并支持利用多个从机节点分布式处理下载负载。
• 📚 压缩文件处理：提供在线压缩、解压缩以及压缩包内容预览功能，支持将多个文件打包为单一文件进行下载。
• 💻 全面协议支持：为所有存储策略提供 WebDAV 协议支持，便于在各种设备和应用中挂载使用。
• ⚡ 便捷上传体验：支持拖拽上传、整个目录上传以及并行分片上传技术，提升大文件传输效率。
• 🗃️ 智能文件管理：可自动提取图片、视频等媒体的元数据信息，支持通过元数据或自定义标签快速检索文件。
• 👩‍👧‍👦 多用户与权限：提供多用户、用户组管理功能，支持配置不同的存储策略和空间配额。
• 🔗 灵活分享机制：可为文件或目录创建分享链接，并能设置访问密码和自动过期时间以增强安全性。
• 👁️‍🗨️ 丰富预览编辑：支持视频、图像、音频、ePub 文档的在线预览，文本文件和 Office 文档可在网页端直接编辑。
• 🎨 个性化与体验：允许自定义界面配色、支持黑暗模式、具备 PWA 应用特性、采用全站单页应用架构并提供多语言国际化支持。
• 🚀 一体化部署：提供 All-in-One 打包方案，简化安装流程，实现开箱即用的部署体验。

官方演示站点（需注册后登录访问）： https://demo.cloudreve.org

安装步骤：通过Docker Compose快速部署

以下 Docker Compose 配置文件用于一键部署 Cloudreve 及其依赖的数据库与缓存服务。

本教程旨在分享一个便捷项目，即通过Docker容器技术实现地下城与勇士（DNF）私服的一键化部署。该方法简化了传统搭建流程，无论是局域网内部联机还是外网访问，均可轻松实现。项目设计初衷是避免复杂的依赖环境配置、手动编译源码或编写大量脚本，只需利用Docker即可快速启动服务，方便与朋友偶尔聚会娱乐。

对于地下城与勇士这款经典游戏，众多老玩家都承载着深厚的情感与记忆。尽管可能因各种原因早已离开官方服务器，但那些游戏时光依然令人怀念。在此，让我们共同回顾一些过往的游戏画面。

项目概述与特性

项目的完整名称为1995chen/dnf，可以在GitHub平台直接搜索找到。该项目将地下城与勇士（常被称为毒奶粉、DNF或DOF）的游戏服务端整合为一个独立的Docker镜像。它以官方CentOS-5/6/7系统镜像作为基础，通过预设环境变量和初始化脚本，实现了应用的快速部署与运行。

该镜像对CPU资源需求不高，内存占用处于合理范围，大约2GB至4GB内存即可流畅运行。当前镜像版本基于85级游戏内容，处于安图恩团队副本上线前的过渡阶段。如果希望体验其他版本，后续可以自行替换相应的PVF文件。项目维护者更新较为频繁，感兴趣的用户可以持续关注其动态。

重要提示：尽管此项目技术支持外网访问，但严禁用于商业开服或任何盈利性运营。仅供个人学习、测试及非商业性质的娱乐用途。

详细部署步骤

本文以威联通NAS设备为例，演示通过Docker Compose方式部署服务。部署代码已预设为外网访问模式，若仅需局域网使用，只需将IP地址替换为内部网络地址即可。

以下为Docker Compose部署代码。建议初次尝试时，除IP地址外，先保持其他默认配置不变，待成功运行后，再清理数据库文件并修改个性化设置重新部署：

services:
  dnf:
    image: 1995chen/dnf:centos7-latest  # 推荐使用此版本
    container_name: dnf
    hostname: dnf
    cap_add:
      - NET_ADMIN
    environment:
      - PUBLIC_IP=xxx.xxx.xxx.xxx  # 替换为你的公网或内网IP
      - WEB_USER=root              # 自定义Web管理用户名
      - WEB_PASS=123456            # 自定义Web管理密码
      - DNF_DB_ROOT_PASSWORD=88888888  # 自定义数据库root密码，需与后续设置对应
      - GM_ACCOUNT=gmuser          # 自定义游戏管理员账号
      - GM_PASSWORD=gmpass         # 自定义游戏管理员密码
      - CLIENT_POOL_SIZE=10
    ports:
      - "180:180"               # supervisor web管理端口
      - "3306:3306"             # MySQL数据库端口
      - "7600:7600"             # 统一登录器端口
      - "881:881"               # 统一网关端口
      - "7001:7001"             # df_channel_r TCP端口
      - "7001:7001/udp"         # df_channel_r UDP端口
      - "30011:30011"           # df_game_r[ch.11] TCP端口
      - "31011:31011/udp"       # df_game_r[ch.11] UDP端口
      - "30052:30052"           # df_game_r[ch.52] TCP端口
      - "31052:31052/udp"       # df_game_r[ch.52] UDP端口
      - "7300:7300"             # df_relay_r TCP端口
      - "7300:7300/udp"         # df_relay_r UDP端口
      - "2311-2313:2311-2313/udp"  # df_stun_r UDP端口范围
    volumes:
      - /share/Container/dnf/log:/home/neople/game/log
      - /share/Container/dnf/mysql:/var/lib/mysql
      - /share/Container/dnf/data:/data
    shm_size: 8g
    restart: always

在威联通NAS的Container Station中，选择创建新的应用程序，并将上述代码粘贴至配置区域。

NapCat是一个致力于打破QQ机器人开发壁垒的开源项目。它利用NTQQ的底层能力，构建了一个无需图形用户界面即可在服务器端稳定运行的Headless框架。无论是个人开发者还是企业用户，NapCat都能提供开箱即用的OneBot 11协议支持，帮助您快速将创意转化为现实应用。

该项目基于TypeScript构建的Bot框架，通过相应的启动器或者框架，主动调用QQ Node模块提供给客户端的接口，从而实现Bot的功能实现。

NapCat与许多其他框架存在本质性的区别，具体表现如下：

• • 与协议端相比，NapCat并非完全自行实现QQ SendMsg这类功能，而是主动调用客户端现有的功能模块。
• • 与Hook端相比，NapCat可以完全自主引导QQ程序的启动过程，而非借助客户端的启动流程，因此API所有权几乎完全拥有，不需要进行Hook操作。
• • 与Electron IPC Hook端对比，NapCat本身并不依赖Electron与注入框架，调用来源是IPC更下层封装的Node模块，甚至可能脱离QQ主程序独立运行。

步骤一：通过Docker Compose快速安装NapCat

使用Docker Compose进行部署时，可以创建如下配置文件：

services:  
napcat:  
    image: mlikiowa/napcat-docker:latest  
    container_name: napcat  
    ports:  
      - 3000:3000  
      - 3001:3001  
      - 6099:6099  
    environment:  
      - NAPCAT_UID=0  
      - NAPCAT_GID=0  
    volumes:  
      - ./QQ:/app/.config/QQ  
      - ./config:/app/napcat/config  
      - ./plugins:/app/napcat/plugins  
    restart: always

关键参数说明如下（更多详细参数建议查阅官方文档）：

:::
/app/.config/QQ（路径，可选）：用于持久化存储QQ相关数据。

/app/napcat/config（路径，可选）：NapCat配置文件所在的目录路径。

/app/napcat/plugins（路径，可选）：NapCat插件目录的存储路径。

:::

步骤二：配置与登录NapCat管理界面

在浏览器中输入 http://NAS的IP:6099 即可访问NapCat的管理界面。

界面首次访问时会提示输入Token，此时需要查看Docker容器的日志信息以获取该Token。

在日志信息的最顶部，通常会出现一个二维码，二维码上方会显示所需的token信息。

接下来需要登录QQ账号，建议使用手机QQ扫描二维码进行登录（推荐使用小号登录，因为电脑客户端可能会被挤下线）。

登录成功后，界面会显示个人信息，这表明NapCat已经成功连接到QQ账号。

在日志中，您可以实时查看QQ接收到的所有消息内容，便于监控和调试。

NapCat支持多种网络配置选项，开发者可以根据需求对接进行通信调试，灵活性较高。