介绍
# ddgr - DuckDuckGo from the Terminal
**ddgr** 是一个用于在终端中搜索 DuckDuckGo 的命令行工具。它无需打开浏览器即可提供快速、注重隐私的网页搜索。
## 安装
### 通过 Snap（推荐用于 Ubuntu）： ```bash sudo snap install ddgr ```
### 通过 PPA： ```bash sudo add-apt-repository ppa:twodopeshaggy/jarun sudo apt-get update sudo apt-get install ddgr ```
### 从源码： ```bash git clone https://github.com/jarun/ddgr.git cd ddgr sudo make install ```
**依赖：** Python 3.8 或更高版本
## 基本用法
### 简单搜索（非交互式）： ```bash snap run ddgr "search query" --np ```
### 指定结果数量的搜索： ```bash snap run ddgr "search query" --num 5 --np ```
### 限制时间的搜索： ```bash snap run ddgr "query" --time w --np # past week snap run ddgr "query" --time m --np # past month snap run ddgr "query" --time y --np # past year ```
### 站点特定搜索： ```bash snap run ddgr "query" --site github.com --np ```
### JSON 输出： ```bash snap run ddgr "query" --json --np ```
### 在浏览器中打开第一个结果： ```bash snap run ddgr "query" --ducky ```
## 交互模式
运行时不带 `--np` 即可进入交互模式： ```bash snap run ddgr "search query" ```
**交互命令：** - `1`, `2`, `3`... → 在浏览器中打开结果 - `n` → 下一页结果 - `p` → 上一页结果 - `q` 或 `Ctrl+D` → 退出 - `?` → 显示帮助
## 高级选项
| 选项 | 描述 | |--------|-------------| | `-n N`, `--num N` | 每页显示 N 个结果（0-25，默认 10） | | `-r REG`, `--reg REG` | 特定区域搜索（例如 'us-en', 'uk-en'） | | `-t SPAN`, `--time SPAN` | 时间限制：d（天），w（周），m（月），y（年） | | `-w SITE`, `--site SITE` | 搜索特定站点 | | `-x`, `--expand` | 显示完整的 URL | | `--json` | 以 JSON 格式输出 | | `--ducky` | 在浏览器中打开第一个结果 | | `--np`, `--noprompt` | 非交互模式 | | `--unsafe` | 禁用安全搜索 |
## DuckDuckGo Bangs
使用 DuckDuckGo Bangs 搜索特定站点： ```bash snap run ddgr "!w Linux" --np # Wikipedia search snap run ddgr "!yt music" --np # YouTube search snap run ddgr "!gh python" --np # GitHub search snap run ddgr "!a books" --np # Amazon search ```
## 使用别名简化操作
添加到 `~/.bashrc` 或 `~/.zshrc`： ```bash alias ddg='snap run ddgr' ```
然后使用： ```bash ddg "search query" --np ```
## 隐私功能
- 不追踪用户或建立用户画像 - 默认启用 Do Not Track - 可通过 Tor 网络工作（需使用代理） - 支持 HTTPS 代理 - 不保存搜索历史
## 示例
### 搜索科技新闻： ```bash snap run ddgr "latest AI news 2025" --num 5 --np ```
### 查找 Ubuntu 教程： ```bash snap run ddgr "Ubuntu tutorial" --site askubuntu.com --np ```
### 搜索最近的 Python 文档： ```bash snap run ddgr "Python 3.12 features" --time m --np ```
### 使用 bang 搜索维基百科： ```bash snap run ddgr "!w OpenClaw" --np ```
## 故障排除
**找不到命令：** - 确保已通过 snap 安装 ddgr：`sudo snap install ddgr` - 使用完整命令：`snap run ddgr` 而不是仅仅 `ddgr`
**没有结果：** - 检查网络连接 - 尝试不带 `--np` 运行，查看交互模式是否正常工作 - 验证 DuckDuckGo 是否可以在你的地区访问
**响应缓慢：** - DuckDuckGo 的 HTML 接口可能比主站慢 - 使用 `--time` 限制结果的时间范围以加快查询速度
## 更多信息
- GitHub: https://github.com/jarun/ddgr - DuckDuckGo: https://duckduckgo.com - Bangs: https://duckduckgo.com/bang