Atuin：29,794 GitHub Stars — Shell 历史同步设置指南 2026

# Unix/macOS — 交互安装带 shell 设置提示
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh

# 非交互（CI、Dockerfiles）
curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh -s -- --non-interactive

# Homebrew（macOS/Linux）
brew install atuin

# Cargo（需 Rust 工具链）
cargo install atuin

# Arch Linux
sudo pacman -S atuin

# NixOS / nix
nix-env -iA nixpkgs.atuin

# Debian/Ubuntu（从 GitHub releases）
VERSION="18.16.1"
curl -LO "https://github.com/atuinsh/atuin/releases/download/v${VERSION}/atuin_${VERSION}_amd64.deb"
sudo dpkg -i "atuin_${VERSION}_amd64.deb"

# Windows（WinGet）
winget install -e Atuinsh.Atuin

# Bash — 加到 ~/.bashrc
eval "$(atuin init bash)"

# Zsh — 加到 ~/.zshrc
eval "$(atuin init zsh)"

# Fish — 加到 ~/.config/fish/config.fish
atuin init fish | source

# Nushell — 加到 config.nu
atuin init nu | save ~/.config/nushell/atuin.nu
source ~/.config/nushell/atuin.nu

# 自动检测 shell 并导入
atuin import auto

# 或显式指定
atuin import bash
atuin import zsh
atuin import fish

# 检查导入了什么
atuin stats

$ atuin --version
atuin 18.16.1

$ atuin doctor
Atuin Doctor
Checking for diagnostics
[✓] Atuin is compiled with sqlite support
[✓] Atuin is compiled with sync support
[✓] Atuin config directory exists

# ~/.config/atuin/config.toml
[settings]
# 搜索模式: prefix, fulltext, fuzzy, skim
search_mode = "fuzzy"

# 过滤模式: global, host, session, directory
filter_mode = "global"

# UI 样式: compact, full
style = "compact"

# 同步设置
auto_sync = true
sync_frequency = "5m"
sync_address = "https://api.atuin.sh"

# 不记录敏感命令（正则模式）
history_filter = [
    "^export.*KEY",
    "^export.*SECRET",
    "^export.*PASSWORD",
    "^aws configure",
    "^ssh-keygen",
]

# 工作目录过滤 — 不在这些路径记录
cwd_filter = [
    "/tmp/secrets",
    "~/.*cred",
]

# Enter 接受命令; false = Tab 编辑首选项
enter_accept = true

# 搜索 UI 显示帮助提示
show_help = false

# 结果数量
inline_height = 20

# 查看当前配置值
atuin config get search_mode
# fuzzy

# 查看解析（有效）值
atuin config get search_mode --resolved
# fuzzy

# 内联设置配置值
atuin config set search_mode fulltext
atuin config set filter_mode directory

# 打印完整配置
atuin config print

# Ctrl+R 交互切换过滤模式
# 默认过滤模式: global -> host -> session -> directory

# 带过滤器命令行搜索
atuin search --exit 0 --after "yesterday 3pm" make
atuin search --before "2026-01-01" --cwd /project deploy
atuin search --exit 1 --session       # 本次会话失败命令

# 删除匹配条目
atuin search --delete "rm -rf /accident"

# ~/.config/starship.toml — 无需特殊配置
# Atuin 处理历史; Starship 处理提示
# 只需确保 Atuin init 在 rc 文件 Starship init 前运行

# ~/.zshrc — 顺序重要
eval "$(atuin init zsh)"       # Atuin 先
eval "$(starship init zsh)"    # Starship 后

# ~/.tmux.conf — 绑定键打开 Atuin 搜索
bind-key r run-shell "tmux send-keys C-r"

# Atuin 自动通过环境变量检测 tmux 会话
# 按会话过滤: 按 Ctrl+R 然后切换过滤模式

# 保持 fzf 用于文件，Atuin 用于历史
# 禁用 fzf 历史绑定（在 ~/.bashrc 或 ~/.zshrc）
export FZF_DEFAULT_COMMAND='fd --type f --hidden'
# 不绑定 Ctrl+R — 让 Atuin 处理

# fzf 用于文件
alias ff='fzf --preview "bat --style=numbers --color=always {}"'

# Atuin 用于历史（自动绑定到 Ctrl+R）

# Dockerfile.dev
RUN curl --proto '=https' --tlsv1.2 -LsSf https://setup.atuin.sh | sh -s -- --non-interactive
COPY config.toml /root/.config/atuin/config.toml
RUN echo 'eval "$(atuin init bash)"' >> /root/.bashrc

# docker-compose.yml
version: "3"
services:
  atuin:
    restart: always
    image: ghcr.io/atuinsh/atuin:latest
    command: server start
    volumes:
      - ./config:/config
      - ./atuin-data:/atuin-data
    links:
      - postgresql
    ports:
      - "8888:8888"
    environment:
      ATUIN_HOST: "0.0.0.0"
      ATUIN_PORT: "8888"
      ATUIN_OPEN_REGISTRATION: "true"
      ATUIN_DB_URI: "postgres://atuin:***@postgresql/atuin"
      RUST_LOG: "info,atuin_server=debug"
    user: "1000:1000"

  postgresql:
    image: postgres:14
    restart: always
    volumes:
      - ./postgres-data:/var/lib/postgresql/data
    environment:
      POSTGRES_USER: atuin
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: atuin
    user: "1000:1000"

  # 可选: 自动备份
  backup:
    image: prodrigestivill/postgres-backup-local
    restart: always
    volumes:
      - ./backups:/backups
    links:
      - postgresql
    environment:
      POSTGRES_HOST: postgresql
      POSTGRES_DB: atuin
      POSTGRES_USER: atuin
      POSTGRES_PASSWORD: change-me
      POSTGRES_EXTRA_OPTS: "-Z6 --schema=public --blobs"
      SCHEDULE: "@daily"
      BACKUP_KEEP_DAYS: "7"

# 创建数据目录
mkdir -p atuin-data postgres-data backups

# 启动服务
docker compose up -d

# 检查健康
curl http://localhost:8888/health
# {"status":"ok"}

# ~/.config/atuin/config.toml
[settings]
sync_address = "http://your-server:8888"
auto_sync = true
sync_frequency = "5m"

# 在你自托管服务器注册新账户
atuin register -u myuser -e myuser@example.com -p securepassword

# 或在附加机器登录
atuin login -u myuser -p securepassword

# 获取你的加密密钥（安全备份）
atuin key
# c2e2d6e5a9b1c3f4d7e8a9b0c1d2e3f4...

# 触发同步
atuin sync

# atuin-deployment.yaml
apiVersion: apps/v1
kind: Deployment
metadata:
  name: atuin-server
spec:
  replicas: 2
  selector:
    matchLabels:
      app: atuin
  template:
    metadata:
      labels:
        app: atuin
    spec:
      containers:
        - name: atuin
          image: ghcr.io/atuinsh/atuin:18.16.1
          command: ["atuin", "server", "start"]
          ports:
            - containerPort: 8888
          env:
            - name: ATUIN_HOST
              value: "0.0.0.0"
            - name: ATUIN_DB_URI
              valueFrom:
                secretKeyRef:
                  name: atuin-db-secret
                  key: uri
---
apiVersion: v1
kind: Service
metadata:
  name: atuin-service
spec:
  selector:
    app: atuin
  ports:
    - port: 8888
      targetPort: 8888