首页/文档/Docker
文档全文

DeepSeek TUI Docker 文档指南

Docker 文档说明了怎样在更可控的环境里运行 DeepSeek TUI,尤其适合依赖隔离或宿主机不稳定的场景。

上游源文件:DOCKER.md站内直接可读原文保留在下方

这份文档真正覆盖什么

Docker 文档说明了怎样在更可控的环境里运行 DeepSeek TUI,尤其适合依赖隔离或宿主机不稳定的场景。

怎么用这页

  • 先看右侧目录,直接跳到你当前最关心的小节。
  • 如果你只是来解决具体问题,优先读正文里的相关标题,再回站内对应 hub。
  • 如果你要核对原始来源,可以直接打开 GitHub 原文链接。

上游文档原文(英文)

Docker

DeepSeek TUI ships an official multi-arch Docker image (amd64 + arm64) on GitHub Container Registry.

Quick start

docker run --rm -it \
  -e DEEPSEEK_API_KEY="$DEEPSEEK_API_KEY" \
  -v ~/.deepseek:/home/deepseek/.deepseek \
  ghcr.io/hmbown/deepseek-tui:latest

Images are published to GitHub Container Registry (GHCR) only. Docker Hub publishing is not currently configured — add a docker/login-action step with Hub credentials to the release workflow if needed.

Environment variables

VariableRequiredDescription
DEEPSEEK_API_KEYyesDeepSeek API key
DEEPSEEK_BASE_URLnoCustom API base URL (e.g. https://api.deepseek.com)
DEEPSEEK_NO_COLORnoSet to 1 to disable terminal colour output

Volumes

Mount ~/.deepseek to persist sessions, config, skills, memory, and the offline queue across container restarts:

-v ~/.deepseek:/home/deepseek/.deepseek

Without this mount the container starts fresh each time.

Non-interactive / pipeline usage

When stdin is not a TTY, deepseek drops to the dispatcher's one-shot mode (deepseek -c "…"). Pipe a prompt on stdin:

echo "Explain the Cargo.toml in structured English." | \
  docker run --rm -i -e DEEPSEEK_API_KEY ghcr.io/hmbown/deepseek-tui:latest

Building locally

# Single platform (your host architecture)
docker build -t deepseek-tui .

# Multi-platform (requires a builder with emulation)
docker buildx create --use
docker buildx build --platform linux/amd64,linux/arm64 -t deepseek-tui .

Devcontainer

The repository includes a .devcontainer/devcontainer.json configuration for VS Code / GitHub Codespaces. It pre-installs the Rust toolchain, rust-analyzer, and the deepseek binary. Open the repo in a devcontainer to get a ready-to-use development environment.

Tags

TagMeaning
latestLatest stable release
v0Latest v0.x release
0.8.9Specific release version

Docker images are built and pushed automatically when a release tag is pushed (see release.yml).

回到顶部