Atuin: 29,794 GitHub Stars — Shell History Sync 完整设置指南 2026

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

# 非交互式（CI、Dockerfile）
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 处理提示符
# 确保在 rc 文件中 Atuin init 在 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:change-me@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

$ atuin stats
[▮▮▮▮▮▮▮▮▮▮]  9,607 fg
[▮▮▮▮▮▮▮▮▮ ]  9,458 vim
[▮▮▮       ]  3,144 ag
[▮▮▮       ]  3,095 git status
[▮▮        ]  2,248 git diff
[▮         ]  1,787 curl
[▮         ]  1,571 jq
[▮         ]  1,357 rg
[▮         ]  1,348 cd
[▮         ]  1,322 git log
Total commands:   62,849
Unique commands:  26,908

# ~/.config/atuin/config.toml
[settings]
history_filter = [
    # AWS 凭证
    "^aws configure",
    "^export AWS_SECRET_ACCESS_KEY",
    # 通用密钥
    "^export.*SECRET",
    "^export.*PASSWORD",
    "^export.*TOKEN",
    "^echo.*password",
    # SSH 密钥
    "^ssh-add",
    "^ssh-keygen",
    # 数据库连接字符串
    "^psql.*://.*:",
    "^mysql.*-p",
]

# SQLite 备份（安全，无锁问题）
sqlite3 ~/.local/share/atuin/history.db ".backup '/backup/atuin-$(date +%Y%m%d).db'"

# 或通过 WAL 检查点复制
cp ~/.local/share/atuin/history.db ~/backups/atuin-backup.db

# 通过 cron 自动每日备份
0 2 * * * sqlite3 ~/.local/share/atuin/history.db ".backup '/backups/atuin/atuin-$(date +\%Y\%m\%d).db'" && find /backups/atuin -mtime +30 -delete

# 检查上次同步时间
atuin sync --force  # 强制同步并显示状态

# 查看同步信息
atuin info
# Atuin v18.16.1
# Sync interval: 5m
# Sync address: https://api.atuin.sh
# Last sync: 2026-05-20T08:15:32Z
# History count: 47,231

# 检查问题
atuin doctor

# ~/.config/atuin/config.toml
[theme]
# 使用终端默认颜色
use_default_colors = true

# 或指定显式颜色
base = "#1e1e2e"
layer1 = "#313244"
text = "#cdd6f4"
accent = "#89b4fa"

# 在旧机器上 — 复制密钥到剪贴板（或通过安全传输）
cat ~/.local/share/atuin/key

# 在新机器上 — 安装并登录后
mkdir -p ~/.local/share/atuin
echo "YOUR_KEY_HERE" > ~/.local/share/atuin/key
chmod 600 ~/.local/share/atuin/key

# 验证同步正常
atuin sync
atuin stats

# ~/.bashrc
export ATUIN_NOBIND=1
eval "$(atuin init bash)"
bind '"\C-r": "\C-aatuin search\C-j"'

# 按搜索模式删除
atuin search --delete "sensitive-command"

# 或使用 TUI — 找到命令，然后按 Alt+Delete