fix(deploy): ipass-agent 加「受管容器」锁,破坏性操作只碰 ipass 容器

问题:update / restart / rollback 的 name 参数**没有任何校验** —— 传
{"name":"invoicehelper-nginx"} 就会去重启/删除同机别的容器(.11 上还跑着
invoicehelper-nginx、d15-nginx-1 等)。

修复:
- 新增 managed_container() / ensure_managed():--name 指定者优先 → 自动探测到的
  ipass 容器 → 两者都没有时退化为 ipass* 前缀白名单
- _post 同步前置校验(非法 name 直接 403、**不建任务**);op_update 内再校验一次
  (op_rollback 内部也走 op_update,纵深防御)
- _dispatch 把 PermissionError 映射为 403;/containers 保留全量但标注 managed;
  / 与 /logs 统一走受管容器
- VERSION 1.0.0 → 1.0.1

本地实测(自造 victim-app + ipass-dt2 两个容器,未触碰任何真实业务容器):
- `--name ipass-dt2`:对 victim-app 发 restart/update/rollback 全部 403,且
  victim-app 的 State.StartedAt 前后完全一致;对 ipass-dt2 正常重启
- 无 `--name` 且机器上没有 ipass 容器:victim-app → 403(前缀白名单);
  ipass-x 通过校验后由 docker 报「No such container」
This commit is contained in:
admin committed 2026-09-12 11:02:28 +08:00
1 parent 327838b427
commit 13c0c7a427
3 files changed
+94 -21

No files matched your search

+77 -17
View File
@@ -27,6 +27,16 @@ ipass-agent — iPass 容器远程更新控制面
token 取值顺序:--token > 环境变量 IPASS_AGENT_TOKEN > ~/.ipass-agent-token
(文件不存在时随机生成并写入,权限 600)
--------------------------------------------------------------------------------
受管容器(限定爆炸半径)—— 重要
--------------------------------------------------------------------------------
本服务等价 docker 权限,但**只操作一个容器**(下称「受管容器」):
① `--name` 显式指定者优先;② 否则自动探测到的 ipass 容器(结果缓存一次)。
两者都没有时退化为主机名前缀白名单(`ipass*`,见 MANAGED_PREFIX)。
update / restart / rollback 若带 `name` 且**不等于**受管容器 → 直接 403,
不建任务、更不会碰那个容器;`GET /containers` 会标明哪个是 managed。
(同一台机器上往往还跑着别的 nginx / 业务容器,绝不能误伤。)
--------------------------------------------------------------------------------
端点一览
--------------------------------------------------------------------------------
@@ -34,8 +44,8 @@ token 取值顺序:--token > 环境变量 IPASS_AGENT_TOKEN > ~/.ipass-agent-t
GET / 服务信息 + 端点清单
GET /check 探测(dry-run):容器 / 端口 / 挂载 / 数据摘要
GET /status 当前容器状态 + 镜像 digest + 数据摘要 + 宿主探活
GET /containers 所有候选容器(名字或镜像含 ipass)
GET /logs?tail=200 容器日志
GET /containers 所有容器(标注哪个是受管容器)
GET /logs?tail=200 受管容器的日志
GET /data?file=users 数据文件摘要(api_key 已脱敏)
GET /jobs?limit=5 最近任务列表
GET /jobs/<id>?offset=N 任务详情 + 增量日志
@@ -44,6 +54,8 @@ token 取值顺序:--token > 环境变量 IPASS_AGENT_TOKEN > ~/.ipass-agent-t
POST /rollback {"tag":...} 回滚到 rollback 标签(异步任务)
POST /restart 只重启容器(同步)
`name` 只接受受管容器(见上);传其它容器名 → 403。
任务(job)在同一时刻**只允许一个**在跑,避免并发删容器互相踩。
"""
@@ -69,7 +81,7 @@ from urllib.parse import urlparse, parse_qs
# ------------------------------------------------------------------ 常量
SERVICE = "ipass-agent"
VERSION = "1.0.0"
VERSION = "1.0.1"
DEFAULT_PORT = 18099
DEFAULT_IMAGE = ("crpi-yscq976uwza88qap.cn-shenzhen.personal.cr.aliyuncs.com/"
@@ -217,6 +229,47 @@ def detect_container(prefer=None):
return None
# ------------------------------------------------- 受管容器(限定爆炸半径)
#
# 本服务等价 docker 权限,而同一台机器上通常还跑着**别的** nginx / 业务容器
# (实测 .11 上就有 invoicehelper-nginx、d15-nginx-1 …)。所有破坏性操作
# (update / restart / rollback)**只允许作用于「受管容器」**:
# ① 显式 `--name` 指定的那个;② 否则自动探测到的 ipass 容器(结果缓存一次)。
# 两者都没有时退化为主机名前缀白名单(`ipass*`)。
# ⚠️ 不要改成「信任调用方传进来的 name」—— 那等于把删/起容器的能力开到全机器。
MANAGED_PREFIX = "ipass"
def managed_container():
"""受管容器名(缓存)。显式 --name 优先,否则自动探测一次。"""
if BACK.get("name"):
return BACK["name"]
if BACK.get("_managed") is None:
BACK["_managed"] = detect_container(None)
return BACK["_managed"]
def ensure_managed(name):
"""把目标容器收敛到受管容器;不合法抛 PermissionError(HTTP 层 → 403)。"""
managed = managed_container()
if not name:
if managed:
return managed
raise PermissionError("未发现受管容器(容器名应以 %r 开头),拒绝操作"
% MANAGED_PREFIX)
if managed:
if name != managed:
raise PermissionError(
"拒绝操作容器 %s:本控制面只管 %s(避免误伤同机其它容器)"
% (name, managed))
return name
if not name.lower().startswith(MANAGED_PREFIX):
raise PermissionError("拒绝操作容器 %s:只允许 %s* 开头的受管容器"
% (name, MANAGED_PREFIX))
return name
def inspect_one(name):
rc, out = docker(["inspect", name])
if rc != 0:
@@ -495,9 +548,9 @@ def op_pull(job, p):
def op_update(job, p):
name = p.get("name") or detect_container(BACK["name"])
if not name:
raise RuntimeError("未发现 ipass 容器,请用 --name 指定或检查 docker ps -a")
# 受管容器约束。HTTP 层已同步校验过一次(非法 name 直接 403、不建任务),
# 这里是纵深防御 —— op_rollback 内部也走 op_update,不能只靠入口把关。
name = ensure_managed(p.get("name"))
image = p.get("image") or DEFAULT_IMAGE
skip_pull = bool(p.get("skip_pull"))
data_override = p.get("data_dir")
@@ -733,7 +786,8 @@ def build_status(name=None):
# ------------------------------------------------------------------ HTTP 层
BACK = {"quiet": False, "name": None, "data_dir": None, "token": ""}
BACK = {"quiet": False, "name": None, "data_dir": None, "token": "",
"_managed": None}
class Handler(BaseHTTPRequestHandler):
@@ -799,6 +853,8 @@ class Handler(BaseHTTPRequestHandler):
if method == "GET":
return self._get(path)
return self._post(path)
except PermissionError as e:
return self._send(403, {"error": str(e)})
except Exception as e: # noqa: BLE001
return self._send(500, {"error": str(e)})
@@ -810,7 +866,8 @@ class Handler(BaseHTTPRequestHandler):
if path == "/":
return self._send(200, {
"service": SERVICE, "version": VERSION, "docker": DOCKER,
"container": detect_container(BACK["name"]),
"container": managed_container(),
"note": "破坏性操作(update/restart/rollback)只作用于 container 这个受管容器",
"default_image": DEFAULT_IMAGE,
"endpoints": [
"GET /health", "GET /check", "GET /status",
@@ -828,9 +885,13 @@ class Handler(BaseHTTPRequestHandler):
if path == "/status":
return self._send(200, build_status(BACK["name"]))
if path == "/containers":
return self._send(200, {"containers": [
{"name": n, "image": i, "status": s}
for n, i, s in list_containers()]})
managed = managed_container()
return self._send(200, {
"managed": managed,
"note": "只有 managed 这个容器会被本服务更新/重启/回滚",
"containers": [
{"name": n, "image": i, "status": s, "managed": n == managed}
for n, i, s in list_containers()]})
if path == "/logs":
name = BACK["name"] or detect_container(None)
if not name:
@@ -888,21 +949,19 @@ class Handler(BaseHTTPRequestHandler):
return self._send(202 if job else 409,
{"job": job["id"]} if job else {"error": err})
if path == "/update":
p.setdefault("name", BACK["name"])
p.setdefault("data_dir", BACK["data_dir"])
p["name"] = ensure_managed(p.get("name")) # 非法 → 403,不建任务
job, err = start_job("update", op_update, p)
return self._send(202 if job else 409,
{"job": job["id"]} if job else {"error": err})
if path == "/rollback":
p.setdefault("name", BACK["name"])
p.setdefault("data_dir", BACK["data_dir"])
p["name"] = ensure_managed(p.get("name"))
job, err = start_job("rollback", op_rollback, p)
return self._send(202 if job else 409,
{"job": job["id"]} if job else {"error": err})
if path == "/restart":
name = p.get("name") or BACK["name"] or detect_container(None)
if not name:
return self._send(404, {"error": "未发现容器"})
name = ensure_managed(p.get("name")) # 非法 → 403
rc, out = docker(["restart", name], timeout=120)
code = http_probe(build_check(name).get("main_port"))
return self._send(200 if rc == 0 else 500,
@@ -985,7 +1044,8 @@ def main():
ap = argparse.ArgumentParser(description="iPass 容器远程更新控制面")
ap.add_argument("--port", type=int, default=DEFAULT_PORT)
ap.add_argument("--bind", default="0.0.0.0")
ap.add_argument("--name", help="容器名(缺省自动探测)")
ap.add_argument("--name", help="受管容器名(缺省自动探测 ipass* 容器;"
"破坏性操作只作用于它)")
ap.add_argument("--data-dir", help="数据目录(缺省从容器挂载读)")
ap.add_argument("--image", help="默认更新目标镜像")
ap.add_argument("--token", help="访问令牌(缺省用环境变量/~/.ipass-agent-token)")