木雷坞-CSDN博客

原创 Docker 镜像源列表（10月19日更新-长期）

一键完成docker安装及镜像加速地址配置，支持拉取 ghcr.io、registry.k8s.io、nvcr.io、quay.io、mcr.microsoft.com、docker.elastic.co 等镜像，docker镜像加速源，长期维护，提供在线支持

2025-06-05 09:57:22 65842 11

原创 docker logs没有输出：标准输出、日志驱动与文件日志排查

-tail 200只取末尾记录，可能错过早先的故障。需要检查已知区间时，换成带明确时区的范围；去掉筛选不能找回已超出保留范围的日志。读取文件或日志平台时，也要核对应用时区、实际文件及对应实例。应用级别过滤、缓冲尚未刷出，或失败请求没有走到该进程，都可能让预期记录缺席；必须结合实际配置和请求证据判断。完整容器ID、故障时间与时区、实际驱动、日志去向、命令结果或读取错误。这份记录说明已经检查到哪一层，而不是用一片空白证明应用没有异常。

2026-10-20 10:28:18 95

原创 Docker Compose端口映射排查：用port和inspect定位网页访问失败

容器显示Up但浏览器连接失败，需逐项排查：1）容器端口发布位置（通过docker compose port或inspect确认宿主机映射）；2）客户端请求地址是否匹配；3）应用是否在目标端口提供服务。仅看运行状态不足，须结合配置、实际映射与请求验证。建议在宿主机使用curl测试，检查日志与监听配置，确保容器内应用监听正确接口。

2026-10-19 13:23:15 140

原创 Docker Compose部署Metabase：应用库隔离与日期筛选看板

本文通过固定版本的Docker Compose配置，将Metabase应用库与业务数据源分离，明确应用身份（metabaseapp）与只读账号权限边界。采用独立角色和数据库，避免初始化卡顿、权限错误及筛选失效问题。附现象排查表，指导用户按配置层级定位问题，确保环境可复现、安全可控，适用于从演示到生产前的标准化部署准备。

2026-10-16 10:58:06 157

原创 Docker Compose部署Docmost：数据库、附件持久化与首次协作

本文基于Docmost 0.96.0，提供自托管部署的完整配置与验收流程，强调独立账号协作、数据持久化与备份恢复。通过Docker Compose实现应用、PostgreSQL 18与Redis 8的隔离部署，使用SSH隧道安全访问，确保首末两步验证：双人编辑同步、附件可取、重建后可用。重点规避附件丢失、权限失效问题，明确区分页面导出与实例备份，最终达成可交付、可恢复、可维护的协作系统。

2026-10-15 14:02:38 241

原创 Docker Compose部署Uptime Kuma 2：持久化、HTTP监控与告警配置

本文详述在Linux服务器上使用Docker Compose部署Uptime Kuma 2.5.6的完整流程，涵盖项目命名、镜像固定、数据卷配置、SSH端口转发初始化数据库、HTTP监控设置、通知绑定与测试、备份脚本编写及故障排查。强调配置完整性，避免因遗漏数据库初始化、网络可达性或卷持久化导致监控失效或配置丢失，提供可复用的标准化部署与维护方案。

2026-10-14 16:40:28 216

原创 2026年10月Docker镜像源清单：地址、配置与验证结果

2026年10月Docker镜像源清单涵盖毫秒镜像、DaoCloud、腾讯云、华为云SWR等主流加速服务，提供地址、配置方法及验证结果。测试显示三项下载成功，一项因压缩层读取超时失败。强调显式路径与透明加速的区别，指导Linux与Docker Desktop配置，建议分三层记录验证结果：元数据、内容下载、本机使用。保留原始错误信息以利排查，不将元数据成功误判为完整拉取成功。

2026-10-12 13:10:29 163

原创 2026年8月国内Docker镜像源清单、配置与验证方法

本文总结了2026年8月国内可用的9个Docker镜像源验证结果，重点测试了5类常用镜像（Docker Hub、GHCR、Kubernetes、Quay、MCR）的访问情况。所有源均通过Registry v2标准认证验证，但建议使用时区分不同镜像来源选择对应入口。文章提供了详细的配置指引（Docker Engine/Desktop、Kubernetes）和四层验证方法（端点响应、Token认证、manifest获取、完整下载），并针对常见错误（401/429/超时等）给出排查建议。强调镜像源会动态变化，关键

2026-08-03 11:33:00 307

原创 AI Coding Agent 开发环境配置：Dev Container、Compose 和镜像预检

本文介绍了如何为AI Coding Agent配置稳定可靠的开发环境。主要方案包括：使用Dev Container固定语言运行时和系统依赖；通过Docker Compose管理数据库等依赖服务；用Makefile/package.json提供统一任务入口；进行镜像预检避免拉取问题。文章提供了详细的目录结构、配置示例和验证步骤，并列出常见问题的排查方法。核心思路是将环境配置显式化、自动化，使AI能按确定路径执行任务，避免因环境问题卡在setup阶段。

2026-07-01 10:46:20 238

原创 Docker Compose 数据卷备份恢复：MySQL/Postgres/Redis 升级前检查清单

本文介绍了Docker Compose环境下升级有状态服务(如MySQL、PostgreSQL、Redis)的安全检查流程。重点强调数据卷管理、备份恢复和升级预检，避免常见的数据丢失风险。主要内容包括：区分镜像/容器/数据卷的关系；慎用down -v命令；推荐使用命名卷；提供MySQL/PostgreSQL/Redis的备份恢复命令；强调恢复验证的重要性；给出完整的升级前检查清单。适用于开发测试环境和轻量业务系统的维护场景，帮助用户建立安全的服务升级流程。

2026-06-30 09:51:45 237

原创 MCP Server Docker 隔离实践：文件、网络、Token 和权限边界

本文介绍了在团队AI编程工具接入MCP Server前的Docker隔离检查方案。重点是通过容器化限制MCP Server权限，避免直接继承主机权限导致的安全风险。文章针对文件类、数据库类等不同MCP Server提供了具体的Docker配置建议，包括禁用网络、挂载特定目录、使用内部网络等隔离措施，并给出了包含镜像来源、用户权限、文件系统等维度的完整检查清单。最后强调Docker沙箱只是安全治理的基础，还需配合最小权限、网络策略等综合措施。

2026-06-25 11:14:42 278

原创 OpenTelemetry Collector Docker 部署排查：OTLP、4317/4318 和 Pipeline

本文介绍了OpenTelemetry Collector的Docker部署排查流程，聚焦最小闭环验证。主要内容包括：建立目标链路：从AI应用经OTLP协议到Collector，最终输出到debug exporter 部署准备：固定镜像版本，使用最小配置文件常见故障排查：容器退出、端口连接、配置无效等问题 AI应用特殊字段建议：需记录模型名称、操作类型等关键指标生产注意事项：需添加批处理、内存限制等配置排查遵循从简到繁原则，先确保基础链路通畅，再接入正式后端组件，以清晰界定问题边界。

2026-06-24 10:50:17 294

原创 MinerU Docker 部署：PDF、DOCX、PPTX 转 Markdown 配置

本文介绍了MinerU文档解析工具在Docker环境下的部署流程和注意事项。MinerU作为RAG和企业知识库的前置解析层，能将PDF、图片、Office文档等转换为结构化Markdown/JSON格式。文章详细说明了环境准备步骤，包括Docker、GPU配置检查；解析了Docker启动关键参数和Compose profile的选择策略；强调了部署后需要重点检查的5类样本文档的解析质量；最后列举了常见问题排查方法和部署建议顺序，指出文档解析层的质量直接影响下游RAG效果。

2026-06-23 09:11:12 429

原创 Meilisearch Docker 自托管排查：镜像、Master Key、数据卷和备份

本文总结了Meilisearch Docker自托管的常见问题排查流程，包括7个关键步骤：1.固定镜像版本；2.设置最小启动命令；3.健康检查；4.管理Master Key和API Keys；5.异步导入文档后检查task状态；6.搜索功能验证；7.制定备份策略。文章特别强调数据持久化、密钥安全管理和异步任务监控的重要性，并建议采用分层API密钥管理。最后指出毫秒镜像仅用于初始预检，后续仍需遵循Meilisearch工程规范进行配置优化。

2026-06-22 10:32:16 203

原创 Firecrawl Docker Compose 自托管排查：镜像、Redis、队列和 Playwright

本文总结了自托管Firecrawl服务时的常见问题及排查方法。Firecrawl是一个网页抓取和内容转换工具，涉及多个组件（API、Playwright、Redis、RabbitMQ等）。主要问题包括镜像拉取失败、端口无响应、队列服务异常等。排查步骤包括：预检GHCR和Docker Hub镜像可用性检查关键环境变量配置查看各容器日志状态测试本地API功能为Playwright服务分配足够资源验证Redis和RabbitMQ服务连通性上线前检查安全设置和资源配置建议在生产环境中固定镜像版本、

2026-06-15 09:40:38 401

原创 LiteLLM Docker 部署：config.yaml、Master Key 和 Postgres 配置

本文介绍了使用Docker部署LiteLLM作为AI模型调用统一网关的方案。重点包括：采用官方镜像源，通过config.yaml配置模型路由和fallback机制，使用.env管理密钥，Postgres持久化配置和预算，Redis缓冲高流量。部署后业务应用通过统一接口调用内部模型名，网关负责密钥管理、路由转发和故障切换。文章提供了验证请求示例和常见问题排查指引，并强调生产环境需固定版本、做好备份和健康检查。该方案将分散的AI模型调用整合为可维护的标准化网关层。

2026-06-11 11:09:29 625

原创 Playwright MCP Docker 部署：mcr 镜像、浏览器工具和权限配置

Playwright MCP 解决的是 Agent 操作浏览器的工具接口问题，Docker 解决的是运行时边界问题。部署时不要只看镜像是否能拉下来，还要把 MCP JSON、容器生命周期、输出目录、账号权限和网络范围一起检查。毫秒镜像在这里的作用很具体：当镜像来自 MCR 时，用先做拉取预检。镜像阶段通过后，后面的重点是浏览器工具边界。

2026-06-09 14:05:52 299

原创 Qdrant Docker 部署教程：数据卷、API Key 和集合初始化

本文介绍了使用Docker Compose部署Qdrant向量数据库的方法，适用于内网知识库、语义搜索等场景。主要内容包括：1）环境配置说明，使用官方镜像和默认端口；2）安全设置，通过API Key实现访问控制；3）使用Docker Compose编排服务；4）collection创建和向量维度配置；5）建议的元数据字段设计；6）反向代理和备份策略。文章提供了完整的配置示例和验证方法，并解答了常见问题，强调向量维度需与embedding模型匹配、备份应采取双重策略等注意事项。部署方案兼顾安全性和实用性，适合

2026-06-08 10:20:53 373

原创 n8n Docker Compose 部署：Postgres、Webhook 和数据卷配置

本文介绍n8n自托管部署方案，采用Docker Compose+Postgres+数据卷+反向代理架构。详细说明了环境要求、镜像预检、env文件配置、compose文件编写、服务启动、反向代理设置等步骤，并提供了数据库备份和升级方法。该方案适合团队内部自动化工作流场景，强调了Postgres数据库的必要性以及备份密钥的重要性，同时解答了SQLite使用、数据卷挂载等常见问题。部署过程需确保镜像、数据库、Webhook和反向代理配置完整才能稳定运行。

2026-06-05 10:09:23 261

原创 6月 Docker 国内镜像源配置：daemon.json、/v2/ 连通性和 pull 验证

本文整理了2026年6月可用的国内Docker镜像源，包括Docker Hub、GHCR、K8s等不同来源的镜像地址。提供了详细的配置步骤：先测试/v2/端点连通性，配置daemon.json文件并重启Docker服务，最后通过拉取nginx、redis等镜像进行验证。文章特别指出Docker Hub镜像源不能覆盖GHCR等特殊仓库，需要单独处理，并列出了一些不建议使用的老旧镜像源地址。同时给出了常见错误的解决方法，建议优先测试docker.1ms.run和docker.m.daocloud.io这两个镜像

2026-06-04 10:55:24 366

原创 Open WebUI Docker 部署：连接 Ollama、数据卷和镜像拉取排查

本文详细介绍了Open WebUI的Docker部署流程，重点解决三大常见问题：1) GHCR镜像拉取困难时可使用毫秒镜像入口预检；2) 连接宿主机Ollama服务时需注意容器网络配置；3) 通过数据卷持久化配置。文章提供了最小化启动命令、参数解释及Docker Compose示例，并针对镜像拉取失败、页面无法打开、模型不可见等问题给出排查方法。部署时建议按顺序检查镜像拉取、容器启动、端口映射、Ollama连接和数据持久化，以提高效率。

2026-06-03 10:11:15 370

原创 Go 项目实战：用 MLiev IAM 落地企业认证中心

企业后台系统增加以后，账号体系很容易变成“每个系统一套”。开发阶段这样做最快，上线后却会留下三个麻烦：登录入口分散，权限回收困难，审计链路不完整。MLiev IAM 可以作为企业认证中心的工程起点。

2026-06-02 09:16:18 513

原创 MLiev IAM 认证中心落地清单：统一登录、RBAC 和审计

本文介绍了MLiev IAM认证中心的落地实施方案，重点解决企业内部多系统账号管理混乱问题。文章从8个关键方面展开：首先明确IAM系统的身份、应用、权限和审计边界；其次强调用户主数据标准化的重要性；然后提出RBAC三层角色模型设计建议；接着说明高频系统优先接入策略；此外还涉及临时权限管理、审计日志记录规范、旧系统迁移验证等内容。最后指出统一身份认证平台的价值在于集中管理账号、应用、角色和审计，为研发、运维和业务系统提供标准化的身份控制层。文章包含具体的技术配置示例和验证清单，为实施企业级IAM系统提供实用指

2026-06-01 11:00:41 390

原创 Docker / K8s 镜像拉取失败排查：专属加速域名与白名单配置思路

本文总结了团队环境中多镜像源混杂导致的拉取问题排查思路。关键点包括：1）区分不同镜像源（Docker Hub、GHCR、Quay等）及其使用场景；2）指出公共加速入口在团队环境中的局限性；3）提出"专属加速域名+源站映射+白名单治理"的解决方案，并给出配置示例；4）强调Kubernetes环境下需注意imagePullPolicy设置；5）建议通过白名单管理、有效期控制和源站映射趋势分析来实现长期治理。文章提供了从问题定位到系统化解决的完整路径，适用于需要统一管理多源镜像的团队环境。

2026-05-29 08:47:39 479

原创 AI Gateway 接入大模型服务后首 token 慢排查：镜像、模型缓存和 GPU 节点

《内网推理服务首token延迟问题排查指南》摘要：本文针对AI推理服务中首次请求响应慢的典型问题，提出了一套系统排查方案。首先需验证基础镜像来源（vLLM/CUDA/K8s组件）的完整性和兼容性，其次检查模型加载路径是否存在存储瓶颈。重点排查方向包括：GPU运行环境是否正常挂载、网关超时设置是否合理、就绪探针是否过早放行流量。建议采用分步验证策略，从镜像预检、模型预热到网关策略逐层排查，特别要注意冷启动场景下网关超时与模型加载时间的匹配问题。通过这种结构化方法可有效定位首token延迟的根本原因。

2026-05-28 10:33:39 447

原创 vLLM 模型服务上线前压测：Docker 镜像、GPU 和 k6 基线检查

本文提供vLLM模型服务上线前的压测检查清单，涵盖镜像验证、GPU运行时检查、模型缓存配置和性能测试等关键环节。通过分步验证Docker镜像、GPU可用性、模型挂载方式，记录冷启动时间，并使用k6工具进行多级并发压测（10/20/50并发），最终形成包含镜像版本、GPU状态、冷启动耗时、性能指标和风险提示的完整上线报告模板，为后续扩容和问题排查建立基准。

2026-05-27 11:36:04 311

原创 dwz-server Docker 部署短链接服务：多域名、A/B 测试和统计配置

本文介绍了木雷短网址(dwz-server)的部署与使用指南。该系统支持短链接生成、多域名管理、A/B测试、点击统计等功能，适用于团队活动页、邀请链接等场景。文章详细说明了最小Docker Compose配置、健康检查、域名配置、生产环境部署建议(Mysql/PostgreSQL+Redis)、A/B测试接口使用、点击统计分析方法以及常见问题解答。该系统既支持SQLite+本地缓存的独立模式用于试用，也支持生产环境的高并发多实例部署，能够满足从个人到企业级的不同需求。

2026-05-26 11:04:10 711 3

原创 Immich Docker Compose 升级后相册索引卡住排查：GHCR 镜像、数据库和存储权限

固定，记录升级前版本。备份数据库和。单独验证 GHCR / Docker Hub 镜像入口。执行。看和database迁移日志。检查/data写入权限。单独排查 machine learning 和任务队列。没有错误但在重建索引时，给它时间。Immich 升级后相册索引卡住，优先按层排：镜像版本、数据库迁移、存储权限、机器学习服务、后台任务。毫秒镜像只适合放在 GHCR 镜像拉取和版本一致性验证这一层。镜像过了，后面仍然要靠日志、备份和权限检查来完成恢复。

2026-05-25 09:53:47 434

原创 Home Assistant Docker Compose 升级失败排查：镜像、备份和设备映射

Home Assistant Docker Compose 升级失败，通常不是单点问题。镜像、配置目录、设备映射、启动迁移、反向代理都要拆开看。毫秒镜像适合解决第一层的 GHCR 镜像拉取验证；后面几层仍然要靠备份、设备路径、日志和代理配置来兜底。升级前把 Compose 和/config备好，回滚会轻很多。

2026-05-22 10:37:52 463

原创 vLLM 服务启动慢排查：NAS 模型目录、Docker 镜像和 GPU Runtime

摘要：本文记录了一次vLLM启动缓慢的排查过程，重点分析了模型文件存放在NAS上时可能出现的各类问题。文章将排查流程分为五个层次：Docker镜像验证、NAS挂载检查、权限与读取速度测试、GPU运行时确认以及vLLM服务就绪检查。针对每个环节提供了详细的诊断命令和解决方案，特别强调了多节点环境下版本一致性、NAS读写权限和延迟测试的重要性。通过系统化的分层排查方法，可以有效定位vLLM启动缓慢的根本原因。

2026-05-21 11:05:23 654 1

原创 GitLab Runner docker pull 慢：并行流水线镜像拉取排查

摘要：团队并行提交MR时出现GitLab Runner队列堆积，主要卡在环境准备阶段的镜像拉取环节。通过分析发现，问题根源在于Docker镜像拉取效率而非测试脚本本身。排查步骤包括：区分job卡顿阶段（pending/preparing/script）、手动验证节点镜像拉取、配置Docker镜像源优化拉取速度、调整pull_policy策略、固定关键镜像版本以避免重复拉取。最终建议结合缓存机制和服务复用，将镜像拉取耗时与测试执行效率分离处理，从而提升CI/CD整体性能。

2026-05-20 09:07:29 992

原创 K8s containerd 镜像源配置：用 1ms-helper 处理 ImagePullBackOff

摘要：本文记录了Kubernetes新节点初始化时遇到的镜像拉取问题排查过程。当节点Ready但Pod因ImagePullBackOff无法启动时，问题通常源于节点containerd的镜像源配置。解决方案包括：1)确认containerd版本；2)使用1ms-helper工具标准化配置；3)针对不同containerd版本（1.5前后）分别配置镜像仓库，新版通过hosts.toml文件，旧版通过config.toml的mirrors设置；4)用crictl命令验证拉取功能。文章强调镜像问题需从节点运行时

2026-05-19 09:25:09 469

原创 K8s v1.36 AI 任务启动失败排查：PodGroup、DRA、ImagePullBackOff

如果这里失败，才进入 GPU Operator、device plugin、PVC、权限和业务参数排查。K8s v1.36 的工作负载感知调度和 DRA 能力，让 AI/ML 任务的资源分配更接近真实需求。但排查启动失败时，仍然要把链路拆清楚：PodGroup 负责成组调度，DRA 负责设备资源，containerd 负责拉镜像，业务容器负责模型加载。不要和 GPU 调度混在一起排。先到目标节点做镜像预检，通常能节省很多绕路时间。

2026-05-18 10:30:48 262

原创 Nginx Proxy Manager 反代 502 排查：Docker 网络、容器端口和上游地址

摘要： Nginx Proxy Manager 出现502错误的常见原因是反代容器无法访问上游服务。排查步骤包括：1)确认后端服务正常运行；2)宿主机测试后端可达性；3)进入NPM容器验证上游连通性；4)检查Docker网络配置，确保NPM与后端容器在同一网络；5)区分宿主机映射端口与容器端口；6)核对协议类型（HTTP/HTTPS）；7)排除镜像拉取失败干扰。通过系统性地验证网络连接、端口映射和容器通信，可快速定位并解决502问题。建议使用统一的反代网络，保持配置一致性。

2026-05-15 09:30:01 445

原创 Jellyfin Docker Compose 媒体库为空排查：volume、PUID/PGID 和挂载路径

摘要： Jellyfin Docker部署后媒体库为空常见问题排查指南。主要检查：1) Docker volume配置是否正确，确保宿主机路径与容器内路径映射无误；2) PUID/PGID权限设置，验证用户对媒体文件的访问权限；3) NAS存储挂载顺序，避免容器启动时目录未就绪。推荐使用最小Compose配置测试，通过docker exec检查容器内文件可见性，并用stat命令验证权限。典型解决方案包括修正路径映射、调整权限、延迟容器启动或添加存储依赖。注意区分媒体库为空（路径/权限问题）与播放卡顿（硬件加

2026-05-14 09:45:27 491

空空如也

空空如也