作者小秋

来源公众号开源前哨

【导语】：自托管、无广告、严格保护隐私的搜索引擎。

简介

Whoogle-search 是一个自托管、免广告的搜索引擎，它不存在 AMP 链、Cookie、IP 追踪等暴露个人隐私的问题。一键即可轻松部署为 Docker 应用程序，拉起来一个免 AD 的搜索服务，用来获取 Google 搜索结果。可作为台式机和移动设备上的主要搜索引擎替代品，快速而简单地实施。

功能特点：

• 没有广告或赞助内容
• 没有 JavaScript 脚本
• 不跟踪/链接个人 IP 地址
• 没有 AMP 链接
• 无 URL 跟踪标记
• 没有引用头
• Tor 和 HTTP/SOCKS 代理支持
• 自动补充/搜索建议
• POST 请求搜索和建议查询
• 主题暗黑模式
• 随机生成的用户代理
• 易于安装/部署
• 可选的基于位置的搜索
• 可选的 NoJS 模式以禁用搜索结果中的所有 Javascript

项目地址：

https://github.com/benbusby/whoogle-search

下载安装

依赖关系

如果使用 Heroku Quick Deploy，则可以跳过此部分内容，否则请参考：

• Docker，仅当打算构建应用程序 Docker 镜像时才需要
• Python 3
• libcurl4-openssl-dev 和 libssl-dev

macOS：

brew install openssl curl-openssl

Ubuntu：

sudo apt-get install -y libcurl4-openssl-dev libssl-dev

Arch：

pacman -S curl openssl

安装

1. Heroku

https://heroku.com/deploy?template=https://github.com/benbusby/whoogle-search/tree/heroku-app-beta

需要 Heroku 账户，Heroku 提供以下功能：

• 免费部署应用
• 免费 HTTPS 网址（https://<应用名称>.herokuapp.com）
• 一段时间不活动后的停机时间，解决方案：

https://github.com/benbusby/whoogle-search#prevent-downtime-heroku-only

2. Repl.it

https://repl.it/github/benbusby/whoogle-search

需要 Replit 账户，Replit 提供以下功能：

• 免费部署应用
• 免费 HTTPS 网址 (https://appname.username.repl.co)，支持自定义域
• 一段时间不活动后的停机时间，解决方案：

https://repl.it/talk/ask/use-this-pingmat1replco-just-enter/28821/101298
https://repl.it/talk/learn/How-to-use-and-setup-UptimeRobot/9003

3. Fly.io

https://fly.io/

需要一个 Fly.io 账户。安装 CLI：

curl -L https://fly.io/install.sh | sh

部署应用：

fly apps create --org personal --port 5000
fly deploy

然后就可以通过 https://app-name.fly.dev 访问应用。

4. pipx 持久化安装：

pipx install git+https://github.com/benbusby/whoogle-search.git

沙盒临时安装：

pipx run --spec git+https://github.com/benbusby/whoogle-search.git whoogle-search

5. pip

pip install whoogle-search

6. 手动安装

clone 代码仓库并运行以下命令，在本地环境中启动应用程序：

git clone https://github.com/benbusby/whoogle-search.git
cd whoogle-search
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt
./run

可以将其添加为系统服务，向 /lib/systemd/system/whoogle.service 文件添加以下内容：

[Unit]
Description=Whoogle

[Service]
# Basic auth configuration, uncomment to enable
#Environment=WHOOGLE_USER=
#Environment=WHOOGLE_PASS=
# Proxy configuration, uncomment to enable
#Environment=WHOOGLE_PROXY_USER=
#Environment=WHOOGLE_PROXY_PASS=
#Environment=WHOOGLE_PROXY_TYPE=
# Site alternative configurations, uncomment to enable
# Note: If not set, the feature will still be available
# with default values. 
#Environment=WHOOGLE_ALT_TW=nitter.net
#Environment=WHOOGLE_ALT_YT=invidious.snopyta.org
#Environment=WHOOGLE_ALT_IG=bibliogram.art/u
#Environment=WHOOGLE_ALT_RD=libredd.it
#Environment=WHOOGLE_ALT_TL=lingva.ml
# Load values from dotenv only
#Environment=WHOOGLE_DOTENV=1
Type=simple
User=root
WorkingDirectory=
ExecStart=/venv/bin/python3 -um app --host 0.0.0.0 --port 5000
ExecReload=/bin/kill -HUP $MAINPID
Restart=always
RestartSec=3
SyslogIdentifier=whoogle

[Install]
WantedBy=multi-user.target

7. Docker 部署 通过 Docker Hub：

docker pull benbusby/whoogle-search
docker run --publish 5000:5000 --detach --name whoogle-search benbusby/whoogle-search:latest

或使用 docker-compose：

git clone https://github.com/benbusby/whoogle-search.git
cd whoogle-search
docker-compose up

或者自行构建镜像运行：

git clone https://github.com/benbusby/whoogle-search.git
cd whoogle-search
docker build --tag whoogle-search:1.0 .
docker run --publish 5000:5000 --detach --name whoogle-search whoogle-search:1.0

浏览器设置

可以在浏览器中设置 Whoogle 作为主要的搜索引擎。

Firefox（桌面版）

• 版本 89+：导航到您应用的网址，右键单击地址栏，然后选择“添加搜索引擎”
• 之前的版本：导航到应用程序的 url，然后单击地址栏中的菜单。在底部，应该有一个“添加搜索引擎”选项
• 添加新的搜索引擎后，打开 Firefox 首选项菜单，单击左侧菜单中的“搜索”，然后使用可用的下拉列表从列表中选择“Whoogle”

Firefox（iOS）

在移动应用设置页面中，点击“常规”部分中的“搜索”。应该有一个标题为“添加搜索引擎”的选项可供选择。提示输入标题和搜索查询 url，使用以下元素填写表单：

• Title: "Whoogle"
• URL: http[s]:///search?q=%s

Firefox（安卓）

• 版本 < 79.0.0：导航到应用程序的网址；长按搜索文本字段；单击“添加搜索引擎”菜单项；选择一个名称，然后单击确定；点击右上角的菜单；导航到设置菜单并选择“搜索”子菜单；选择 Whoogle 并按“设为默认值”；
• 版本 >= 79.0.0：点击右上角的菜单，导航到设置菜单并选择“搜索”子菜单；点击“添加搜索引擎”；选择“其他”单选按钮，使用以下元素填写表单：

名称: "Whoogle"
要使用的搜索字符串: https://

Alfred (Mac OS X)

• 转到 Alfred Preferences > Features > Web Search 并单击 Add Custom Search。然后配置这些设置：

搜索网址：`https:///search?q={query}
标题：（随意）
关键词：whoogle

• 转到 Default Results 并单击 Setup fallback results 按钮。单击 + 并添加 Whoogle，然后将其拖到顶部。

基于 Chrome/Chromium 的浏览器

• 自动添加：访问 Whoogle Search 实例的主页。这可能会自动将搜索引擎添加到搜索引擎列表中。如果没有，可以手动添加。
• 手动添加：在搜索引擎 > 管理搜索引擎 > 添加下，使用 whoogle url/search?q=%s 格式的 URL 手动输入 Whoogle 实例详细信息。