案例
做过的项目
三个本地 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。