Marico's space
跑 AI Agent 钱包的容器不用 root 身份运行，这不只是一个安全建议——而是防止权限提升攻击的关键手段，一旦被突破，你整个宿主机都得完蛋。尤其是你的交易机器人或者 DeFi Agent 在处理真实资金的时候，遵循最小权限原则已经成了基础设施的基本卫生要求。
容器安全漏洞是云基础设施里增长最快的攻击向量之一。一个被攻破的 root 容器可以直接逃逸到宿主机，访问其他容器，不光能掏空你 Agent 的钱包，同一台机器上跑的任何服务都得遭殃。对于自己托管 AI Agent 基础设施的人来说，这不光是资金风险，还涉及隐私安全。
传统的钱包服务默认以 root 运行，白白增加了攻击面。AI Agent 每天要做几百笔 DeFi 交易，每次 API 调用、每次智能合约交互、每次交易签名操作都可能是入侵点。以 root 运行意味着一个漏洞就能升级成系统级沦陷。
自托管 AI Agent 基础设施面临独特的挑战。跟简单的 Web 应用不一样，Agent 需要持久访问私钥、维持到区块链网络的 WebSocket 连接，还得集成外部 API——这些 API 随时可能返回恶意响应。安全事件的影响范围不只是宕机时间，而是实打实的经济损失。
WAIaaS 容器默认以 UID 1001 运行，为自托管部署实现了纵深防御安全设计。这个设计选择反映了一种更宏观的安全理念：假设必然被突破，控制影响范围。
WAIaaS 的 Docker 镜像实现了多个非 root 安全模式：
# Create non-root user
RUN addgroup --system --gid 1001 waiaas && \ adduser --system --uid 1001 --ingroup waiaas waiaas # Switch to non-root user
USER waiaas:waiaas # Ensure data directory permissions
WORKDIR /data
这个配置确保容器化守护进程永远不会以 root 权限运行，即便宿主机上的 Docker 守护进程本身以 root 运行也没用。
对于生产级自托管部署，WAIaaS 支持通过 Docker Compose 安全功能进行额外加固：
services: daemon: image: ghcr.io/minhoyoo-iotrust/waiaas:latest container_name: waiaas-daemon user: "1001:1001" # Explicitly set non-root user ports: - "127.0.0.1:3100:3100" # Bind only to localhost volumes: - waiaas-data:/data environment: - WAIAAS_DATA_DIR=/data - WAIAAS_DAEMON_HOSTNAME=0.0.0.0 security_opt: - no-new-privileges:true # Prevent privilege escalation cap_drop: - ALL # Drop all capabilities cap_add: - NET_BIND_SERVICE # Only add required capabilities read_only: true # Read-only root filesystem tmpfs: - /tmp restart: unless-stopped healthcheck: test: ["CMD", "curl", "-f", "http://localhost:3100/health"] interval: 30s timeout: 5s start_period: 10s retries: 3 volumes: waiaas-data: driver: local
这个配置实现了多层安全：非 root 执行、权限降级、只读文件系统、以及仅绑定 localhost 的网络。
以 UID 1001 运行需要对卷挂载权限格外注意。WAIaaS 通过智能入口脚本处理数据目录所有权问题，不需要 root 权限也能搞定。
自动配置功能在维持非 root 执行的同时生成安全的主密码：
# Deploy with auto-provision (generates secure random password)
docker run -d \ --name waiaas \ --user 1001:1001 \ -p 127.0.0.1:3100:3100 \ -v waiaas-data:/data \ -e WAIAAS_AUTO_PROVISION=true \ ghcr.io/minhoyoo-iotrust/waiaas:latest # Retrieve generated password securely
docker exec waiaas cat /data/recovery.key
自动配置生成的密码使用加密安全的随机数生成，提供高熵值，同时不需要在自动化部署中可能危及安全的交互式设置。
对于生产部署，WAIaaS 集成 Docker Secrets 来避免环境变量暴露：
# Create secret files with proper permissions
mkdir -p secrets
echo "your-secure-password" > secrets/master_password.txt
chmod 600 secrets/master_password.txt
chown 1001:1001 secrets/master_password.txt # Deploy with secrets overlay
docker compose -f docker-compose.yml -f docker-compose.secrets.yml up -d
secrets overlay 确保敏感配置永远不会出现在进程列表、环境变量转储或容器检查输出中。
自托管 AI Agent 基础设施应该尽量减少网络暴露。WAIaaS 默认只绑定 localhost（127.0.0.1:3100:3100），而不是在所有接口上暴露服务。
这个设计选择遵循的安全原则是：AI Agent 应该和应用部署在一起，而不是作为网络服务对外暴露。如果确实需要外部访问，应该通过带正确认证的反向代理走流量，而不是直接暴露容器。
WAIaaS 实现了三层认证，与非 root 执行无缝配合：
# masterAuth — system administration (requires strong password)
curl -X POST http://127.0.0.1:3100/v1/wallets \ -H "Content-Type: application/json" \ -H "X-Master-Password: your-secure-password" \ -d '{"name": "trading-wallet", "chain": "solana", "environment": "mainnet"}' # sessionAuth — AI agent operations (time-limited JWT)
curl http://127.0.0.1:3100/v1/wallet/balance \ -H "Authorization: Bearer wai_sess_eyJhbGciOiJIUzI1NiJ9..."
会话令牌提供时限访问，可以配置 TTL、maxRenewals 和 absoluteLifetime 参数，确保被泄露的令牌影响范围有限。
非 root 容器能实现更好的安全监控，因为权限提升尝试会立即暴露出来。WAIaaS 提供健康检查端点和结构化日志，可以集成到监控系统中：
# Container health monitoring
docker compose logs -f daemon # Check daemon status
curl -f http://127.0.0.1:3100/health
健康检查端点返回详细状态信息，如果钱包操作不可用或守护进程检测到安全策略违规，可以触发告警。
克隆和配置：git clone https://github.com/minhoyoo-iotrust/WAIaaS.git && cd WAIaaS
自动配置部署：docker compose up -d（自动以 UID 1001 运行）
获取安全凭证：docker exec waiaas-daemon cat /data/recovery.key
创建钱包和会话：使用 CLI 设置 AI Agent 访问和适当权限
验证安全：用 docker exec waiaas-daemon id 检查容器是否以非 root 运行
自托管 AI Agent 基础设施需要持续的安全维护和监控。考虑实现日志聚合、自动备份策略和网络监控，以保持长期的安全态势。
准备好以适当的权限分离部署安全的 AI Agent 钱包了吗？可以查看 WAIaaS GitHub 仓库 获取完整的部署指南和安全配置，或者访问 waiaas.ai 探索完整的安全架构。
原文链接：https://dev.to/running-ai-agent-wallets-as-non-root-docker-uid-1001-security-best-practices