安装: Docker run

目标和结果

完成此页面专用的流程： 安装: Docker run. 此流程使用 DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

适用范围

本页面仅适用于 安装: Docker run (Docker). 通道与数据边界为： DiscVault · ghcr.io/helmerznl/discvault:latest; PostgreSQL API MCP; 6080 → API 5000; DiscVault · ghcr.io/helmerznl/discvault:beta; PostgreSQL API MCP; 6080 → API 5000. 本页面专用检查点： DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

DiscVault v26 稳定版

DiscVault · ghcr.io/helmerznl/discvault:latest
PostgreSQL API MCP
6080 → API 5000

DiscVault v26 测试版

DiscVault · ghcr.io/helmerznl/discvault:beta
PostgreSQL API MCP
6080 → API 5000

前提条件

Docker Engine 24+
OpenSSL
6080:5000

操作步骤

记录: DISCVAULT_IMAGE · :latest :beta
创建: --env-file · DATABASE_URL · 仅所有者可访问的文件权限 (0600)
启动: discvault-postgres → discvault-api → MCP
验证: 6080:5000 · GET /api/next/health

命令和设置

DiscVault v26 稳定版

export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:latest

DiscVault v26 测试版

export DISCVAULT_IMAGE=ghcr.io/helmerznl/discvault:beta

两个通道

set -euo pipefail
test -n "$DISCVAULT_IMAGE"
case "$DISCVAULT_IMAGE" in
  ghcr.io/helmerznl/discvault:latest|ghcr.io/helmerznl/discvault:beta) ;;
  *) printf '%s\n' "$DISCVAULT_IMAGE" >&2; exit 64 ;;
esac
install -d -m 0700 /opt/discvault
install -d -m 0750 /srv/discvault
install -d -o 70 -g 70 -m 0700 /srv/discvault-postgres
umask 077
ENV_FILE=/opt/discvault/docker-run.env
test ! -e "$ENV_FILE"
ENV_TMP="$(mktemp "$ENV_FILE.tmp.XXXXXX")"
trap 'rm -f "$ENV_TMP"' EXIT
POSTGRES_PASSWORD="$(openssl rand -hex 32)"
JWT_SECRET="$(openssl rand -hex 32)"
printf '%s\n' \
  'POSTGRES_DB=discvault' \
  'POSTGRES_USER=discvault' \
  "POSTGRES_PASSWORD=$POSTGRES_PASSWORD" \
  "DATABASE_URL=postgresql://discvault:$POSTGRES_PASSWORD@discvault-postgres:5432/discvault" \
  "JWT_SECRET=$JWT_SECRET" \
  'TZ=Europe/Amsterdam' \
  'RP_ID=localhost' \
  'RP_NAME=DiscVault' \
  'RP_ORIGINS=http://localhost:6080' \
  'DISCVAULT_DATA_DIR=/data' \
  'DISCVAULT_PLUGIN_INSTALL_DIR=/data/plugins' \
  'DISCVAULT_WORKER_ID=worker-1' \
  'DISCVAULT_WORKER_POLL_INTERVAL=2' \
  'DISCVAULT_API=http://discvault-api:5000' > "$ENV_TMP"
chmod 0600 "$ENV_TMP"
ln "$ENV_TMP" "$ENV_FILE"
rm -f "$ENV_TMP"
trap - EXIT
docker network inspect discvault >/dev/null 2>&1 || docker network create discvault
docker run -d --name discvault-postgres --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" \
  --health-cmd 'pg_isready -U "$POSTGRES_USER" -d "$POSTGRES_DB"' \
  --health-interval 10s --health-timeout 5s --health-retries 10 \
  -v /srv/discvault-postgres:/var/lib/postgresql/data postgres:17-alpine
until [ "$(docker inspect discvault-postgres --format '{{.State.Health.Status}}')" = healthy ]; do
  sleep 2
done
docker run -d --name discvault-api --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" -w /opt/discvault/backend \
  -p 6080:5000 -v /srv/discvault:/data "$DISCVAULT_IMAGE" \
  sh -c 'python next_database.py migrate && exec gunicorn --bind 0.0.0.0:5000 --workers 2 --timeout 180 next_app:app'
until curl --fail http://localhost:6080/api/next/health; do sleep 2; done
docker run -d --name discvault-worker --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" -w /opt/discvault/backend \
  -v /srv/discvault:/data "$DISCVAULT_IMAGE" python next_worker.py work
docker run -d --name discvault-mcp --restart unless-stopped \
  --network discvault --env-file "$ENV_FILE" -w /opt/discvault/mcp-server \
  -p 6090:6090 "$DISCVAULT_IMAGE" \
  python server.py --http --host 0.0.0.0 --port 6090
docker ps --filter 'name=discvault-'

预期结果

仅在以下条件下接受结果： 安装: Docker run 必须确认以下所有结果： HTTP 2xx · /api/next/health; discvault-postgres. 本页面专用检查点： DATABASE_URL · discvault-postgres · 6080:5000 · /api/next/health.

HTTP 2xx · /api/next/health
discvault-postgres

安全与回滚

下一步

安装: 首次启动和健康检查

来源和状态

helmerzNL/DiscVault@6d27c689ac21
来源和状态: 2026-07-14
DiscVault Docs: 0.1.0