案例

做过的项目

三个本地 AI 和自托管的项目:dsh 容器化、Traefik 迁移、Harbor 镜像仓库。客户和机器细节都隐去了。

这几个项目是什么

三个能讲、但不用提客户名字的项目。机器参数做了模糊处理,问题和做法是实际发生的。代码是简化片段,域名和路径都是占位。

1. 一台每次重启都要手动拉起的机器

简单说:机器现在能自己起来,升级坏了也能退回去。

问题:dsh 是手动跑的:一个终端、模型地址写在 shell 配置里、插件全局安装。重启后服务不会自己起来,有一次升级还把插件搞坏了。

做了什么:把 dsh 装进固定版本的容器,$DSH_HOME 和工作区分别挂卷,Web 端口放在 Traefik 后面,模型凭据运行时注入,并把一次升级和回滚的路径写下来。

# compose 片段:固定镜像版本,状态放在卷里
services:
  dsh:
    image: local/dsh:0.2.2
    command: ["dsh", "web", "--port", "8080"]
    ports:
      - "127.0.0.1:8080:8080"   # 走 Traefik 或 cloudflared,不直接暴露公网
    volumes:
      - ./dsh-home:/data/dsh
      - ./workspace:/workspace
    environment:
      DSH_HOME: /data/dsh
    restart: unless-stopped

留下了什么:容器随系统启动,$DSH_HOME 的备份,一份简短的升级手册,以及一张验证清单(Web、插件、会话)。

2. 八个服务,一个入口

简单说:八个服务都在一个入口后面,证书自己续,不用谁记着。

问题:NAS 上八个自托管服务,端口散在各处的笔记里,证书靠手动续。

做了什么:按域名整理路由表,拆分 Traefik 静态和动态配置,用 DNS-01 申请证书,按域名逐个切换,旧代理配置保留以便回退。

# 动态配置片段
http:
  routers:
    grafana:
      rule: "Host(`grafana.home.arpa`)"
      entryPoints: [websecure]
      service: grafana
      tls:
        certResolver: le
  services:
    grafana:
      loadBalancer:
        servers:
          - url: "http://10.0.20.5:3000"

留下了什么:一个入口、自动续期的证书、一张自己能改的路由表,以及 502/404 的排查顺序。

3. 全组都能拉的镜像

简单说:大家拉的是同一个镜像,旧的也会清掉。

问题:镜像在一台笔记本上构建,再拷来拷去;同事拉到的可能是哪台机器上碰巧留着的 tag。

做了什么:Harbor 两个项目加角色权限,存储放在现有阵列上,配置保留策略和垃圾回收,并把本地镜像迁过去。

# harbor.yml 片段
hostname: harbor.home.arpa
data_volume: /srv/harbor
storage_service:
  filesystem:
    rootdirectory: /storage

留下了什么:带版本的拉取方式、清理流程、配置和数据库的备份步骤,以及升级说明。

怎么干活

  • 先定范围,再报价。
  • 一次接得不多,没有团队流水线。
  • 交付里有配置、文档和回退办法。
  • 案例里不出现客户名字和机器细节。
  • 完整的项目过程,附一份示例记录。

下一步

有问题就发邮件。纠错、提问或者聊项目,都发到 [email protected]。本页也有 Markdown 版本:/zh/work.md。

不确定从哪开始?

先做一次资源评估,或者把配置和目标发到邮箱。回复会说范围合不合适、下一步要什么。