everywall /ladder

Selfhosted alternative to 12ft.io. and 1ft.io. Proxy to remove CORS headers and modify HTML

★ 9,433⑂ 542👁 37⑃ 104● 54▤ 21
GoGPL-3.0Created 2023-11-01
下载:v0.0.23v0.0.23 ↓0.0.232026-05-04
+4
日增长
9,433
stars
542
forks
37
watchers
104
prs
54
issues
21
releases

README

Ladder
     

English | 简体中文

Ladder 是一个 HTTP 网页代理。

Ladder 是一个面向开发者的工具,用于测试和分析现代网站上的付费墙实现与内容投放行为。

它可以帮助开发者、研究人员和发布者模拟不同的客户端环境(例如浏览器和爬虫),观察网站在不同条件下如何返回内容。这对于调试付费墙配置、验证访问控制和 HTTP 头、确认不同 User-Agent 下行为一致等场景都非常有用。

Ladder 仅用于合法的测试、研究和质量保障目的,使用时应遵守相关法律法规以及目标网站的服务条款。

!screenshot

 工作原理

mermaid
sequenceDiagram
    client-+ladder: GET
    ladder--ladder: apply RequestModifications
    ladder-+website: GET
    website--ladder: 200 OK
    ladder--ladder: apply ResultModifications
    ladder--client: 200 OK


 功能特性
- [x] 移除/修改响应、静态资源和图片中的 CORS 头
- [x] 移除/修改其他响应头(例如 Content-Security-Policy)
- [x] 移除/注入自定义代码(HTML、CSS、JavaScript)到页面中
- [x] 按域名应用规则集/代码,对响应或请求 URL 进行修改
- [x] 保持站点可正常浏览
- [x] 提供 API
- [x] 获取原始 HTML
- [x] 自定义 User-Agent
- [x] 自定义 X-Forwarded-For IP
- [x] Docker 镜像(amd64、arm64)
- [x] Linux 二进制
- [x] macOS 二进制
- [x] Windows 二进制(未经测试)
- [x] 基本认证(Basic Auth)
- [x] 访问日志
- [x] 可能会破坏跟踪、广告和其他第三方内容
- [x] 限制代理仅作用于指定域名列表
- [x] 将自身规则集对外暴露给其他 ladder 实例
- [ ] Robots.txt 测试
- [ ] 可选 TOR 代理
- [ ] 通过密钥分享被代理的 URL

 局限性
部分网站会根据访问客户端的类型(例如搜索引擎爬虫与普通浏览器)返回不同的内容,这种行为称为 Cloaking(内容隐藏)。Ladder 可以被配置为模拟不同的客户端类型,以便用于测试、自动化或研究等用途获取公开可访问的内容。

不过,许多网站会通过指纹识别、速率限制或行为分析等更高级的机制来限制自动化访问。Ladder 并不会绕过这类保护,在那些主动限制或管控访问的服务上可能无法正常工作。

像 FlareSolverr 这样的第三方工具可以独立用于在无头浏览器环境中渲染网页。它们并不属于 Ladder 的一部分,使用这类工具时也可能受到法律和合同方面的约束。用户需自行确保自己的使用方式符合所有适用的法规。

 安装

 警告: 如果你的实例对外公开访问,请务必启用基本认证,否则任何人都可以借助你的代理浏览不当或违法内容,由此产生的责任将由你承担。

 二进制
1) 在此处下载二进制文件
2) 解压后运行 ./ladder -r https://raw.githubusercontent.com/everywall/ladder-rules/main/ruleset.yaml
3) 打开浏览器(默认地址:http://localhost:8080)

 Docker
bash
docker run -p 8080:8080 -d --env RULESET=https://raw.githubusercontent.com/everywall/ladder-rules/main/ruleset.yaml --name ladder ghcr.io/everywall/ladder:latest


 Docker Compose
bash
curl https://raw.githubusercontent.com/everywall/ladder/main/docker-compose.yaml --output docker-compose.yaml
docker-compose up -d


 Helm
详见 helm-chart 子目录下的 README.md。

 使用方法

 浏览器
1) 打开浏览器(默认地址:http://localhost:8080)
2) 输入 URL
3) 按下回车

或者直接将 URL 拼接到代理地址末尾访问:
http://localhost:8080/https://www.example.com

也可以创建一个包含以下脚本的书签:
javascript
javascript:window.location.href="http://localhost:8080/"+location.href


 API
bash
curl -X GET "http://localhost:8080/api/https://www.example.com"


 RAW
http://localhost:8080/raw/https://www.example.com


 查看运行中的规则集
http://localhost:8080/ruleset

 配置

 环境变量

| 变量 | 说明 | 取值 |
| --- | --- | --- |
| PORT | 监听端口 | 8080 |
| PREFORK | 启动多个服务实例 | false |
| USER_AGENT | 模拟的 User-Agent | Mozilla/5.0 (compatible; Googlebot/2.1; +http://www.google.com/bot.html) |
| X_FORWARDED_FOR | 转发的 IP 地址 | 66.249.66.1 |
| USERPASS | 启用基本认证,格式为 admin:123456 |  |
| LOG_URLS | 是否记录已抓取的 URL | true |
| DISABLE_FORM | 是否禁用 URL 表单首页 | false |
| FORM_PATH | 自定义表单 HTML 的路径 |  |
| RULESET | 规则集文件的路径或 URL,支持本地目录 | https://raw.githubusercontent.com/everywall/ladder-rules/main/ruleset.yaml 或 /path/to/my/rules.yaml 或 /path/to/my/rules/ |
| EXPOSE_RULESET | 将自身规则集对外暴露给其他 ladder 实例 | true |
| ALLOWED_DOMAINS | 允许访问的域名列表,使用逗号分隔;为空表示不限制 

Top issues

Discussions

Latest release

v0.0.23 v0.0.23 2026-05-04
What's Changed
 Bump actions/setup-go from 3 to 6 in /.github/workflows by @dependabot[bot] in https://github.com/everywall/ladder/pull/112
 Bump docker/login-action from 2 to 4 in /.github/workflows by @dependabot[bot] in https://github.com/everywall/ladder/pull/121
 Bump pnpm/action-setup from 2 to 6 in /.github/workflows by @dependabot[bot] in https://github.com/everywall/ladder/pull/117
 Bump actions/checkout from 3 to 6 in /.github/workflows by @dependabot[bot] in https://github.com/everywall/ladder/pull/116
 fix: increase request header buffer size by @anguscloud in https://github.c

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON