[
{
"path": ".air.toml",
"content": "root = \".\"\ntmp_dir = \"var\"\n\n[build]\ncmd = \"go build -o ./var/main ./cmd/anubis\"\nbin = \"./var/main\"\nargs = [\"--use-remote-address\"]\nexclude_dir = [\"var\", \"vendor\", \"docs\", \"node_modules\"]\n\n[logger]\ntime = true\n# to change flags at runtime, prepend with -- e.g. $ air -- --target http://localhost:3000 --difficulty 20 --use-remote-address\n"
},
{
"path": ".devcontainer/Dockerfile",
"content": "FROM ghcr.io/xe/devcontainer-base/pre/go\n\nWORKDIR /app\n\nCOPY go.mod go.sum package.json package-lock.json ./\nRUN apt-get update \\\n && apt-get -y install zstd brotli redis \\\n && mkdir -p /home/vscode/.local/share/fish \\\n && chown -R vscode:vscode /home/vscode/.local/share/fish \\\n && chown -R vscode:vscode /go\n\nCMD [\"/usr/bin/sleep\", \"infinity\"]"
},
{
"path": ".devcontainer/README.md",
"content": "# Anubis Dev Container\n\nAnubis offers a [development container](https://containers.dev/) image in order to make it easier to contribute to the project. This image is based on [Xe/devcontainer-base/go](https://github.com/Xe/devcontainer-base/tree/main/src/go), which is based on Debian Bookworm with the following customizations:\n\n- [Fish](https://fishshell.com/) as the shell complete with a custom theme\n- [Go](https://go.dev) at the most recent stable version\n- [Node.js](https://nodejs.org/en) at the most recent stable version\n- [Atuin](https://atuin.sh/) to sync shell history between your host OS and the development container\n- [Docker](https://docker.com) to manage and build Anubis container images from inside the development container\n- [Ko](https://ko.build/) to build production-ready Anubis container images\n- [Neovim](https://neovim.io/) for use with Git\n\nThis development container is tested and known to work with [Visual Studio Code](https://code.visualstudio.com/). If you run into problems with it outside of VS Code, please file an issue and let us know what editor you are using.\n"
},
{
"path": ".devcontainer/devcontainer.json",
"content": "// For format details, see https://aka.ms/devcontainer.json. For config options, see the\n// README at: https://github.com/devcontainers/templates/tree/main/src/debian\n{\n \"name\": \"Dev\",\n \"dockerComposeFile\": [\"./docker-compose.yaml\"],\n \"service\": \"workspace\",\n \"workspaceFolder\": \"/workspace/anubis\",\n \"postStartCommand\": \"bash ./.devcontainer/poststart.sh\",\n \"features\": {\n \"ghcr.io/xe/devcontainer-features/ko:1.1.0\": {},\n \"ghcr.io/devcontainers/features/github-cli:1\": {}\n },\n \"initializeCommand\": \"mkdir -p ${localEnv:HOME}${localEnv:USERPROFILE}/.local/share/atuin\",\n \"customizations\": {\n \"vscode\": {\n \"extensions\": [\n \"esbenp.prettier-vscode\",\n \"ms-azuretools.vscode-containers\",\n \"golang.go\",\n \"unifiedjs.vscode-mdx\",\n \"a-h.templ\",\n \"redhat.vscode-yaml\",\n \"streetsidesoftware.code-spell-checker\"\n ],\n \"settings\": {\n \"chat.instructionsFilesLocations\": {\n \".github/copilot-instructions.md\": true\n }\n }\n }\n }\n}\n"
},
{
"path": ".devcontainer/docker-compose.yaml",
"content": "services:\n playwright:\n image: mcr.microsoft.com/playwright:v1.52.0-noble\n init: true\n network_mode: service:workspace\n command:\n - /bin/sh\n - -c\n - npx -y playwright@1.52.0 run-server --port 9001 --host 0.0.0.0\n\n valkey:\n image: valkey/valkey:8\n pull_policy: always\n\n # VS Code workspace service\n workspace:\n image: ghcr.io/techarohq/anubis/devcontainer\n build:\n context: ..\n dockerfile: .devcontainer/Dockerfile\n volumes:\n - ../:/workspace/anubis:cached\n environment:\n VALKEY_URL: redis://valkey:6379/0\n #entrypoint: [\"/usr/bin/sleep\", \"infinity\"]\n user: vscode\n"
},
{
"path": ".devcontainer/poststart.sh",
"content": "#!/usr/bin/env bash\n\npwd\n\nnpm ci &\ngo mod download &\ngo install ./utils/cmd/... &\n\nwait\n"
},
{
"path": ".gitattributes",
"content": "**/*_templ.go linguist-generated=true\n"
},
{
"path": ".github/FUNDING.yml",
"content": "patreon: cadey\ngithub: xe\nliberapay: Xe\n"
},
{
"path": ".github/ISSUE_TEMPLATE/bug_report.yaml",
"content": "name: Bug report\ndescription: Create a report to help us improve\n\nbody:\n - type: textarea\n id: description-of-bug\n attributes:\n label: Describe the bug\n description: A clear and concise description of what the bug is.\n placeholder: I can reliably get an error when...\n validations:\n required: true\n\n - type: textarea\n id: steps-to-reproduce\n attributes:\n label: Steps to reproduce\n description: |\n Steps to reproduce the behavior.\n placeholder: |\n 1. Go to the following url...\n 2. Click on...\n 3. You get the following error: ...\n validations:\n required: true\n\n - type: textarea\n id: expected-behavior\n attributes:\n label: Expected behavior\n description: |\n A clear and concise description of what you expected to happen.\n Ideally also describe *why* you expect it to happen.\n placeholder: Instead of displaying an error, it would...\n validations:\n required: true\n\n - type: input\n id: version-os\n attributes:\n label: Your operating system and its version.\n description: Unsure? Visit https://whatsmyos.com/\n placeholder: Android 13\n validations:\n required: true\n\n - type: input\n id: version-browser\n attributes:\n label: Your browser and its version.\n description: Unsure? Visit https://www.whatsmybrowser.org/\n placeholder: Firefox 142\n validations:\n required: true\n\n - type: textarea\n id: additional-context\n attributes:\n label: Additional context\n description: Add any other context about the problem here.\n"
},
{
"path": ".github/ISSUE_TEMPLATE/config.yml",
"content": "blank_issues_enabled: false\ncontact_links:\n - name: Security\n url: https://techaro.lol/contact\n about: Do not file security reports here. Email security@techaro.lol.\n"
},
{
"path": ".github/ISSUE_TEMPLATE/feature_request.yaml",
"content": "name: Feature request\ndescription: Suggest an idea for this project\ntitle: \"[Feature request] \"\n\nbody:\n - type: textarea\n id: description-of-bug\n attributes:\n label: Is your feature request related to a problem? Please describe.\n description: A clear and concise description of what the problem is that made you submit this report.\n placeholder: I am always frustrated, when...\n validations:\n required: true\n\n - type: textarea\n id: description-of-solution\n attributes:\n label: Solution you would like.\n description: A clear and concise description of what you want to happen.\n placeholder: Instead of behaving like this, there should be...\n validations:\n required: true\n\n - type: textarea\n id: alternatives\n attributes:\n label: Describe alternatives you have considered.\n description: A clear and concise description of any alternative solutions or features you have considered.\n placeholder: Another workaround that would work, is...\n validations:\n required: false\n\n - type: textarea\n id: additional-context\n attributes:\n label: Additional context\n description: Add any other context (such as mock-ups, proof of concepts or screenshots) about the feature request here.\n validations:\n required: false\n"
},
{
"path": ".github/PULL_REQUEST_TEMPLATE.md",
"content": "\n\nChecklist:\n\n- [ ] Added a description of the changes to the `[Unreleased]` section of docs/docs/CHANGELOG.md\n- [ ] Added test cases to [the relevant parts of the codebase](https://github.com/TecharoHQ/anubis/blob/main/CONTRIBUTING.md)\n- [ ] Ran integration tests `npm run test:integration` (unsupported on Windows, please use WSL)\n- [ ] All of my commits have [verified signatures](https://anubis.techaro.lol/docs/developer/signed-commits)\n"
},
{
"path": ".github/actions/spelling/README.md",
"content": "# check-spelling/check-spelling configuration\n\n| File | Purpose | Format | Info |\n| -------------------------------------------------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------- |\n| [dictionary.txt](dictionary.txt) | Replacement dictionary (creating this file will override the default dictionary) | one word per line | [dictionary](https://github.com/check-spelling/check-spelling/wiki/Configuration#dictionary) |\n| [allow.txt](allow.txt) | Add words to the dictionary | one word per line (only letters and `'`s allowed) | [allow](https://github.com/check-spelling/check-spelling/wiki/Configuration#allow) |\n| [reject.txt](reject.txt) | Remove words from the dictionary (after allow) | grep pattern matching whole dictionary words | [reject](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-reject) |\n| [excludes.txt](excludes.txt) | Files to ignore entirely | perl regular expression | [excludes](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-excludes) |\n| [only.txt](only.txt) | Only check matching files (applied after excludes) | perl regular expression | [only](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-only) |\n| [patterns.txt](patterns.txt) | Patterns to ignore from checked lines | perl regular expression (order matters, first match wins) | [patterns](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-patterns) |\n| [candidate.patterns](candidate.patterns) | Patterns that might be worth adding to [patterns.txt](patterns.txt) | perl regular expression with optional comment block introductions (all matches will be suggested) | [candidates](https://github.com/check-spelling/check-spelling/wiki/Feature:-Suggest-patterns) |\n| [line_forbidden.patterns](line_forbidden.patterns) | Patterns to flag in checked lines | perl regular expression (order matters, first match wins) | [patterns](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-patterns) |\n| [expect.txt](expect.txt) | Expected words that aren't in the dictionary | one word per line (sorted, alphabetically) | [expect](https://github.com/check-spelling/check-spelling/wiki/Configuration#expect) |\n| [advice.md](advice.md) | Supplement for GitHub comment when unrecognized words are found | GitHub Markdown | [advice](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples%3A-advice) |\n\nNote: you can replace any of these files with a directory by the same name (minus the suffix)\nand then include multiple files inside that directory (with that suffix) to merge multiple files together.\n"
},
{
"path": ".github/actions/spelling/advice.md",
"content": " \nIf the flagged items are :exploding_head: false positives \n\nIf items relate to a ...\n\n- binary file (or some other file you wouldn't want to check at all).\n\n Please add a file path to the `excludes.txt` file matching the containing file.\n\n File paths are Perl 5 Regular Expressions - you can [test](https://www.regexplanet.com/advanced/perl/) yours before committing to verify it will match your files.\n\n `^` refers to the file's path from the root of the repository, so `^README\\.md$` would exclude [README.md](../tree/HEAD/README.md) (on whichever branch you're using).\n\n- well-formed pattern.\n\n If you can write a [pattern](https://github.com/check-spelling/check-spelling/wiki/Configuration-Examples:-patterns) that would match it,\n try adding it to the `patterns.txt` file.\n\n Patterns are Perl 5 Regular Expressions - you can [test](https://www.regexplanet.com/advanced/perl/) yours before committing to verify it will match your lines.\n\n Note that patterns can't match multiline strings.\n\n[optional scope]: \n\n[optional body]\n\n[optional footer(s)]\n```\n\n**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`\n\n- Add `!` after type/scope for breaking changes or include `BREAKING CHANGE:` in the footer.\n- Keep descriptions concise, imperative, lowercase, and without a trailing period.\n- Reference issues/PRs in the footer when applicable.\n- **ALL git commits MUST be made with `--signoff`.** This is mandatory.\n\n### Attribution Requirements\n\nAI agents must disclose what tool and model they are using in the \"Assisted-by\" commit footer:\n\n```text\nAssisted-by: [Model Name] via [Tool Name]\n```\n\nExample:\n\n```text\nAssisted-by: GLM 4.6 via Claude Code\n```\n\n## PR Checklist\n\n- Add description of changes to `[Unreleased]` in `docs/docs/CHANGELOG.md`.\n- Add test cases for bug fixes and behavior changes.\n- Run integration tests: `npm run test:integration`.\n- All commits must have verified (signed) signatures.\n\n## Key Conventions\n\n- **Security-first**: This is security software. Code reviews are strict. Always add tests for bug fixes. Consider adversarial inputs.\n- **Configuration**: YAML-based policy files. Config structs validate via `Valid() error` methods returning sentinel errors.\n- **Store interface**: `lib/store.Interface` abstracts key-value storage.\n- **Environment variables**: Parsed from flags via `flagenv`. Use `.env` files locally (loaded by `godotenv/autoload`). Never commit `.env` files.\n- **Assets must be built first**: JS/CSS assets are embedded into the Go binary. Always run `npm run assets` before `go test` or `go build`.\n- **CEL expressions**: Policy rules support CEL (Common Expression Language) expressions for advanced matching. See `lib/policy/expressions/`."
},
{
"path": "Brewfile",
"content": "# programming languages\nbrew \"go@1.24\"\nbrew \"node\"\nbrew \"ko\"\nbrew \"esbuild\"\nbrew \"zstd\"\nbrew \"brotli\""
},
{
"path": "CLAUDE.md",
"content": "@AGENTS.md\n@CONTRIBUTING.md\n"
},
{
"path": "CONTRIBUTING.md",
"content": "# Contributing to Anubis\n\nAnubis is a Web AI Firewall Utility (WAIFU) written in Go. It uses sha256 proof-of-work challenges to protect upstream HTTP resources from scraper bots. This is security software -- correctness matters.\n\n## Build & Run\n\nPrerequisites: Go 1.24+, Node.js (any supported version), esbuild, gzip, zstd, brotli. Install all with `brew bundle` if you are using Homebrew.\n\n```shell\nnpm ci # install node dependencies\nnpm run assets # build JS/CSS (required before any Go build/test)\nnpm run build # assets + go build -> ./var/anubis\nnpm run dev # assets + run locally with --use-remote-address\n```\n\n## Testing\n\n```shell\n# Run all unit tests (assets must be built first)\nnpm run test # or: make test\n\n# Run a single test by name\ngo test -run TestClampIP ./internal/\n\n# Run a single test file's package\ngo test ./lib/config/\n\n# Run tests with verbose output\ngo test -v -run TestBotValid ./lib/config/\n```\n\n### Smoke tests\n\nThe `tests` folder contains \"smoke tests\" that are intended to set up Anubis in production-adjacent settings and testing it against real infrastructure tools. A smoke test is a folder with `test.sh` that sets up infrastructure, validates the behaviour, and then tears it down. Smoke tests are run in GitHub actions with `.github/workflows/smoke-tests.yaml`.\n\n## Linting\n\n```shell\ngo vet ./...\ngo tool staticcheck ./...\ngo tool govulncheck ./...\n```\n\n## Code Generation\n\nThe project uses `go generate` for templ templates and stringer. Always run `npm run generate` (or `make assets`) before building or testing. Generated files include:\n\n- `web/*.templ` -> templ-generated Go code\n- `web/static/` -> bundled/minified JS and CSS (with .gz, .zst, .br variants)\n\n## Project Layout\n\nImportant folders:\n\n- `cmd/anubis`: Main entrypoint for the project. This is the program that runs on servers.\n- `lib/*`: The core library for Anubis and all of its features. This is internal code that is made public for ease of downstream consumption. No API stability is guaranteed. Use at your own risk.\n- `internal/*`: Actual internal code that is private to the implementation of Anubis. If you need to use a package in this, please copy it out and manually vendor it in your own project.\n- `test/*` Smoke tests (see dedicated section for details).\n- `web`: Frontend HTML templates.\n- `xess`: Frontend CSS framework and build logic.\n\n## Code Style\n\n### Go\n\nThis project follows the idioms of the Go standard library. Generally follow the patterns that upstream Go uses, including:\n\n- Prefer packages from the standard library unless there is no other option.\n- Use package import aliases only when package names collide.\n- Use `goimports` to format code. Run with `npm run format`.\n- Use sentinel errors as package-level variables prefixed with `Err` (such as `ErrBotMustHaveName`). Wrap with `fmt.Errorf(\"package: small message giving context: %w\", err)`.\n- Use `log/slog` for structured logging. Pass loggers as arguments to functions. Use `lg.With` to preload with context. Prefer using `slog.Debug` unless you absolutely need to report messages to users, some users have magical thinking about log verbosity.\n- Name PublicFunctionsAndTypes in PascalCase. Name privateFunctionsAndTypes in camelCase.\n- Acronyms stay uppercase (`URL`, `HTTP`, `IP`, `DNS`, etc.)\n- Enumerations should use strong types with validation logic for parsing remote input.\n- Be conservative in what you send but liberal in what you accept.\n- Anything reading configuration values should use both `json` and `yaml` struct tags. Use pointer values for optional configuration values.\n- Use [table-driven tests](https://go.dev/wiki/TableDrivenTests) when writing test code.\n- Use [`t.Helper()`](https://pkg.go.dev/testing#T.Helper) in helper code (setup/teardown scaffolding).\n- Use [`t.Cleanup()`](https://pkg.go.dev/testing#T.Cleanup) to tear down per-test or per-suite scaffolding.\n- Use [`errors.Is`](https://pkg.go.dev/errors#Is) for validating function results against sentinel errors.\n- Prefer same-package tests over black-box tests (`_test` packages).\n\n### JavaScript / TypeScript\n\n- Source lives in `web/js/`. Built with esbuild, bundled and minified.\n- Uses Preact (not React).\n- No linter config. Keep functions small. Use `const` by default.\n\n### Templ Templates\n\nAnubis uses [Templ](https://templ.guide) for generating HTML on the server.\n\n- `.templ` files in `web/` generate Go code. Run `go generate ./...` (or `npm run assets`) after modifying them.\n- Templates receive typed Go parameters. Keep logic in Go, not templates.\n\n## Commit Messages\n\nCommit messages follow the [**Conventional Commits**](https://www.conventionalcommits.org/en/v1.0.0/) format:\n\n```text\n[optional scope]: \n\n[optional body]\n\n[optional footer(s)]\n```\n\n**Types**: `feat`, `fix`, `docs`, `style`, `refactor`, `perf`, `test`, `build`, `ci`, `chore`, `revert`\n\n- Add `!` after type/scope for breaking changes or include `BREAKING CHANGE:` in the footer.\n- Keep descriptions concise, imperative, lowercase, and without a trailing period.\n- Reference issues/PRs in the footer when applicable.\n- **ALL git commits MUST be made with `--signoff`.** This is mandatory.\n\n### Attribution Requirements\n\nAI agents must disclose what tool and model they are using in the \"Assisted-by\" commit footer:\n\n```text\nAssisted-by: [Model Name] via [Tool Name]\n```\n\nExample:\n\n```text\nAssisted-by: GLM 4.6 via Claude Code\n```\n\n## PR Checklist\n\n- Add description of changes to `[Unreleased]` in `docs/docs/CHANGELOG.md`.\n- Add test cases for bug fixes and behavior changes.\n- Run integration tests: `npm run test:integration`.\n- All commits must have verified (signed) signatures.\n\n## Key Conventions\n\n- **Security-first**: This is security software. Code reviews are strict. Always add tests for bug fixes. Consider adversarial inputs.\n- **Configuration**: YAML-based policy files. Config structs validate via `Valid() error` methods returning sentinel errors.\n- **Store interface**: `lib/store.Interface` abstracts key-value storage.\n- **Environment variables**: Parsed from flags via `flagenv`. Use `.env` files locally (loaded by `godotenv/autoload`). Never commit `.env` files.\n- **Assets must be built first**: JS/CSS assets are embedded into the Go binary. Always run `npm run assets` before `go test` or `go build`.\n- **CEL expressions**: Policy rules support CEL (Common Expression Language) expressions for advanced matching. See `lib/policy/expressions/`.\n"
},
{
"path": "LICENSE",
"content": "Copyright (c) 2025 Xe Iaso \n\nPermission is hereby granted, free of charge, to any person obtaining a copy\nof this software and associated documentation files (the \"Software\"), to deal\nin the Software without restriction, including without limitation the rights\nto use, copy, modify, merge, publish, distribute, sublicense, and/or sell\ncopies of the Software, and to permit persons to whom the Software is\nfurnished to do so, subject to the following conditions:\n\nThe above copyright notice and this permission notice shall be included in\nall copies or substantial portions of the Software.\n\nTHE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR\nIMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,\nFITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE\nAUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER\nLIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,\nOUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN\nTHE SOFTWARE.\n"
},
{
"path": "Makefile",
"content": "VERSION= $(shell cat ./VERSION)\nGO?= go\nNPM?= npm\n\n.PHONY: build assets deps lint prebaked-build test\n\nall: build\n\ndeps:\n\t$(NPM) ci\n\t$(GO) mod download\n\nassets: PATH:=$(PWD)/node_modules/.bin:$(PATH)\nassets: deps\n\t$(GO) generate ./...\n\t./web/build.sh\n\t./xess/build.sh\n\nbuild: assets\n\t$(GO) build -o ./var/anubis ./cmd/anubis\n\t$(GO) build -o ./var/robots2policy ./cmd/robots2policy\n\t@echo \"Anubis is now built to ./var/anubis\"\n\nlint: assets\n\t$(GO) vet ./...\n\t$(GO) tool staticcheck ./...\n\t\nprebaked-build:\n\t$(GO) build -o ./var/anubis -ldflags \"-X 'github.com/TecharoHQ/anubis.Version=$(VERSION)'\" ./cmd/anubis\n\t$(GO) build -o ./var/robots2policy -ldflags \"-X 'github.com/TecharoHQ/anubis.Version=$(VERSION)'\" ./cmd/robots2policy\n\ntest: assets\n\t$(GO) test ./...\n"
},
{
"path": "README.md",
"content": "# Anubis\n\n\n \n\n\n\n\n\n\n[](https://github.com/sponsors/Xe)\n\n## Sponsors\n\nAnubis is brought to you by sponsors and donors like:\n\n### Diamond Tier\n\n\n \n\n \n\n### Gold Tier\n\n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n \n\n## Overview\n\nAnubis is a Web AI Firewall Utility that [weighs the soul of your connection](https://en.wikipedia.org/wiki/Weighing_of_souls) using one or more challenges in order to protect upstream resources from scraper bots.\n\nThis program is designed to help protect the small internet from the endless storm of requests that flood in from AI companies. Anubis is as lightweight as possible to ensure that everyone can afford to protect the communities closest to them.\n\nAnubis is a bit of a nuclear response. This will result in your website being blocked from smaller scrapers and may inhibit \"good bots\" like the Internet Archive. You can configure [bot policy definitions](./docs/docs/admin/policies.mdx) to explicitly allowlist them and we are working on a curated set of \"known good\" bots to allow for a compromise between discoverability and uptime.\n\nIn most cases, you should not need this and can probably get by using Cloudflare to protect a given origin. However, for circumstances where you can't or won't use Cloudflare, Anubis is there for you.\n\nIf you want to try this out, visit the Anubis documentation site at [anubis.techaro.lol](https://anubis.techaro.lol).\n\n## Support\n\nIf you run into any issues running Anubis, please [open an issue](https://github.com/TecharoHQ/anubis/issues/new?template=Blank+issue). Please include all the information I would need to diagnose your issue.\n\nFor live chat, please join the [Patreon](https://patreon.com/cadey) and ask in the Patron discord in the channel `#anubis`.\n\n## Star History\n\n\n \n \n \n\n## Packaging Status\n\n[](https://repology.org/project/anubis-anti-crawler/versions)\n\n## Contributors\n\n\n \n\nMade with [contrib.rocks](https://contrib.rocks).\n"
},
{
"path": "SECURITY.md",
"content": "# Security Policy\n\nTecharo follows the [Semver 2.0 scheme](https://semver.org/).\n\n## Supported Versions\n\nTecharo strives to support the two most recent minor versions of Anubis. Patches to those versions will be published as patch releases.\n\n## Reporting a Vulnerability\n\nEmail security@techaro.lol with details on the vulnerability and reproduction steps. You will get a response as soon as possible.\n\nPlease take care to send your email as a mixed plaintext and HTML message. Messages with GPG signatures or that are plaintext only may be blocked by the spam filter.\n"
},
{
"path": "VERSION",
"content": "1.25.0\n"
},
{
"path": "anubis.go",
"content": "// Package anubis contains the version number of Anubis.\npackage anubis\n\nimport \"time\"\n\n// Version is the current version of Anubis.\n//\n// This variable is set at build time using the -X linker flag. If not set,\n// it defaults to \"devel\".\nvar Version = \"devel\"\n\n// CookieName is the name of the cookie that Anubis uses in order to validate\n// access.\nvar CookieName = \"techaro.lol-anubis\"\n\n// TestCookieName is the name of the cookie that Anubis uses in order to check\n// if cookies are enabled on the client's browser.\nvar TestCookieName = \"techaro.lol-anubis-cookie-verification\"\n\n// CookieDefaultExpirationTime is the amount of time before the cookie/JWT expires.\nconst CookieDefaultExpirationTime = 7 * 24 * time.Hour\n\n// BasePrefix is a global prefix for all Anubis endpoints. Can be emptied to remove the prefix entirely.\nvar BasePrefix = \"\"\n\n// PublicUrl is the externally accessible URL for this Anubis instance.\nvar PublicUrl = \"\"\n\n// StaticPath is the location where all static Anubis assets are located.\nconst StaticPath = \"/.within.website/x/cmd/anubis/\"\n\n// APIPrefix is the location where all Anubis API endpoints are located.\nconst APIPrefix = \"/.within.website/x/cmd/anubis/api/\"\n\n// DefaultDifficulty is the default \"difficulty\" (number of leading zeroes)\n// that must be met by the client in order to pass the challenge.\nconst DefaultDifficulty = 4\n\n// ForcedLanguage is the language being used instead of the one of the request's Accept-Language header\n// if being set.\nvar ForcedLanguage = \"\"\n\n// UseSimplifiedExplanation can be set to true for using the simplified explanation\nvar UseSimplifiedExplanation = false\n"
},
{
"path": "cmd/containerbuild/.gitignore",
"content": "images"
},
{
"path": "cmd/containerbuild/main.go",
"content": "package main\n\nimport (\n\t\"flag\"\n\t\"fmt\"\n\t\"log\"\n\t\"log/slog\"\n\t\"os\"\n\t\"os/exec\"\n\t\"path/filepath\"\n\t\"strings\"\n\n\t\"github.com/TecharoHQ/anubis/internal\"\n\t\"github.com/facebookgo/flagenv\"\n)\n\nvar (\n\tdockerAnnotations = flag.String(\"docker-annotations\", os.Getenv(\"DOCKER_METADATA_OUTPUT_ANNOTATIONS\"), \"Docker image annotations\")\n\tdockerLabels = flag.String(\"docker-labels\", os.Getenv(\"DOCKER_METADATA_OUTPUT_LABELS\"), \"Docker image labels\")\n\tdockerRepo = flag.String(\"docker-repo\", \"registry.int.xeserv.us/techaro/anubis\", \"Docker image repository for Anubis\")\n\tdockerTags = flag.String(\"docker-tags\", os.Getenv(\"DOCKER_METADATA_OUTPUT_TAGS\"), \"newline separated docker tags including the registry name\")\n\tgithubEventName = flag.String(\"github-event-name\", \"\", \"GitHub event name\")\n\tpullRequestID = flag.Int(\"pull-request-id\", -1, \"GitHub pull request ID\")\n\tslogLevel = flag.String(\"slog-level\", \"INFO\", \"logging level (see https://pkg.go.dev/log/slog#hdr-Levels)\")\n)\n\nfunc main() {\n\tflagenv.Parse()\n\tflag.Parse()\n\n\tslog.SetDefault(internal.InitSlog(*slogLevel, os.Stderr))\n\n\tkoDockerRepo := strings.TrimSuffix(*dockerRepo, \"/\"+filepath.Base(*dockerRepo))\n\n\tif *githubEventName == \"pull_request\" && *pullRequestID != -1 {\n\t\t*dockerRepo = fmt.Sprintf(\"ttl.sh/techaro/pr-%d/anubis\", *pullRequestID)\n\t\t*dockerTags = fmt.Sprintf(\"ttl.sh/techaro/pr-%d/anubis:24h\", *pullRequestID)\n\t\tkoDockerRepo = fmt.Sprintf(\"ttl.sh/techaro/pr-%d\", *pullRequestID)\n\n\t\tslog.Info(\n\t\t\t\"Building image for pull request\",\n\t\t\t\"docker-repo\", *dockerRepo,\n\t\t\t\"docker-tags\", *dockerTags,\n\t\t\t\"github-event-name\", *githubEventName,\n\t\t\t\"pull-request-id\", *pullRequestID,\n\t\t)\n\t}\n\n\tif strings.Contains(*dockerTags, \",\") {\n\t\tnewTags := strings.Join(strings.Split(*dockerTags, \",\"), \"\\n\")\n\t\tdockerTags = &newTags\n\t}\n\n\tsetOutput(\"docker_image\", strings.SplitN(*dockerTags, \"\\n\", 2)[0])\n\n\tversion, err := run(\"git describe --tags --always --dirty\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tcommitTimestamp, err := run(\"git log -1 --format='%ct'\")\n\tif err != nil {\n\t\tlog.Fatal(err)\n\t}\n\n\tslog.Debug(\n\t\t\"ko env\",\n\t\t\"KO_DOCKER_REPO\", koDockerRepo,\n\t\t\"SOURCE_DATE_EPOCH\", commitTimestamp,\n\t\t\"VERSION\", version,\n\t)\n\n\tos.Setenv(\"KO_DOCKER_REPO\", koDockerRepo)\n\tos.Setenv(\"SOURCE_DATE_EPOCH\", commitTimestamp)\n\tos.Setenv(\"VERSION\", version)\n\n\tsetOutput(\"version\", version)\n\n\tif *dockerTags == \"\" {\n\t\tlog.Fatal(\"Must set --docker-tags or DOCKER_METADATA_OUTPUT_TAGS\")\n\t}\n\n\timages, err := parseImageList(*dockerTags)\n\tif err != nil {\n\t\tlog.Fatalf(\"can't parse images: %v\", err)\n\t}\n\n\tfor _, img := range images {\n\t\tif img.repository != *dockerRepo {\n\t\t\tslog.Error(\n\t\t\t\t\"Something weird is going on. Wanted docker repo differs from contents of --docker-tags. Did a flag get set incorrectly?\",\n\t\t\t\t\"wanted\", *dockerRepo,\n\t\t\t\t\"got\", img.repository,\n\t\t\t\t\"docker-tags\", *dockerTags,\n\t\t\t)\n\t\t\tos.Exit(2)\n\t\t}\n\t}\n\n\tvar tags []string\n\tfor _, img := range images {\n\t\ttags = append(tags, img.tag)\n\t}\n\n\toutput, err := run(fmt.Sprintf(\"ko build --platform=all --base-import-paths --tags=%q --image-user=1000 --image-annotation=%q --image-label=%q ./cmd/anubis | tail -n1\", strings.Join(tags, \",\"), *dockerAnnotations, *dockerLabels))\n\tif err != nil {\n\t\tlog.Fatalf(\"can't run ko build, check stderr: %v\", err)\n\t}\n\n\tsp := strings.SplitN(output, \"@\", 2)\n\n\tsetOutput(\"digest\", sp[1])\n}\n\ntype image struct {\n\trepository string\n\ttag string\n}\n\nfunc parseImageList(imageList string) ([]image, error) {\n\timages := strings.Split(imageList, \"\\n\")\n\tvar result []image\n\tfor _, img := range images {\n\t\tif img == \"\" {\n\t\t\tcontinue\n\t\t}\n\n\t\t// reg.xeiaso.net/techaro/anubis:latest\n\t\t// repository: reg.xeiaso.net/techaro/anubis\n\t\t// tag: latest\n\t\tindex := strings.LastIndex(img, \":\")\n\t\tresult = append(result, image{\n\t\t\trepository: img[:index],\n\t\t\ttag: img[index+1:],\n\t\t})\n\t}\n\n\tif len(result) == 0 {\n\t\treturn nil, fmt.Errorf(\"no images provided, bad flags\")\n\t}\n\n\treturn result, nil\n}\n\n// run executes a command and returns the trimmed output.\nfunc run(command string) (string, error) {\n\tbin, err := exec.LookPath(\"sh\")\n\tif err != nil {\n\t\treturn \"\", err\n\t}\n\tslog.Debug(\"running command\", \"command\", command)\n\tcmd := exec.Command(bin, \"-c\", command)\n\tcmd.Stderr = os.Stderr\n\tout, err := cmd.Output()\n\tif err != nil {\n\t\treturn \"\", err\n\t}\n\treturn strings.TrimSpace(string(out)), nil\n}\n\nfunc setOutput(key, val string) {\n github_output := os.Getenv(\"GITHUB_OUTPUT\")\n f, _ := os.OpenFile(github_output, os.O_WRONLY|os.O_APPEND|os.O_CREATE, 0644)\n fmt.Fprintf(f, \"%s=%s\\n\", key, val)\n f.Close()\n}\n"
},
{
"path": "cmd/robots2policy/batch/batch_process.go",
"content": "/*\nBatch process robots.txt files from archives like https://github.com/nrjones8/robots-dot-txt-archive-bot/tree/master/data/cleaned\ninto Anubis CEL policies. Usage: go run batch_process.go \n*/\npackage main\n\nimport (\n\t\"fmt\"\n\t\"io/fs\"\n\t\"log\"\n\t\"os\"\n\t\"os/exec\"\n\t\"path/filepath\"\n\t\"strings\"\n)\n\nfunc main() {\n\tif len(os.Args) < 2 {\n\t\tfmt.Println(\"Usage: go run batch_process.go \")\n\t\tfmt.Println(\"Example: go run batch_process.go ./cleaned\")\n\t\tos.Exit(1)\n\t}\n\n\tcleanedDir := os.Args[1]\n\toutputDir := \"generated_policies\"\n\n\t// Create output directory\n\tif err := os.MkdirAll(outputDir, 0755); err != nil {\n\t\tlog.Fatalf(\"Failed to create output directory: %v\", err)\n\t}\n\n\tcount := 0\n\terr := filepath.WalkDir(cleanedDir, func(path string, d fs.DirEntry, err error) error {\n\t\tif err != nil {\n\t\t\treturn err\n\t\t}\n\n\t\t// Skip directories\n\t\tif d.IsDir() {\n\t\t\treturn nil\n\t\t}\n\n\t\t// Generate policy name from file path\n\t\trelPath, _ := filepath.Rel(cleanedDir, path)\n\t\tpolicyName := strings.ReplaceAll(relPath, \"/\", \"-\")\n\t\tpolicyName = strings.TrimSuffix(policyName, \"-robots.txt\")\n\t\tpolicyName = strings.ReplaceAll(policyName, \".\", \"-\")\n\n\t\toutputFile := filepath.Join(outputDir, policyName+\".yaml\")\n\n\t\tcmd := exec.Command(\"go\", \"run\", \"main.go\",\n\t\t\t\"-input\", path,\n\t\t\t\"-output\", outputFile,\n\t\t\t\"-name\", policyName,\n\t\t\t\"-format\", \"yaml\")\n\n\t\tif err := cmd.Run(); err != nil {\n\t\t\tfmt.Printf(\"Warning: Failed to process %s: %v\\n\", path, err)\n\t\t\treturn nil // Continue processing other files\n\t\t}\n\n\t\tcount++\n\t\tif count%100 == 0 {\n\t\t\tfmt.Printf(\"Processed %d files...\\n\", count)\n\t\t} else if count%10 == 0 {\n\t\t\tfmt.Print(\".\")\n\t\t}\n\n\t\treturn nil\n\t})\n\n\tif err != nil {\n\t\tlog.Fatalf(\"Error walking directory: %v\", err)\n\t}\n\n\tfmt.Printf(\"Successfully processed %d robots.txt files\\n\", count)\n\tfmt.Printf(\"Generated policies saved to: %s/\\n\", outputDir)\n}\n"
},
{
"path": "cmd/robots2policy/main.go",
"content": "package main\n\nimport (\n\t\"bufio\"\n\t\"encoding/json\"\n\t\"flag\"\n\t\"fmt\"\n\t\"io\"\n\t\"log\"\n\t\"net/http\"\n\t\"os\"\n\t\"regexp\"\n\t\"slices\"\n\t\"strings\"\n\n\t\"github.com/TecharoHQ/anubis/lib/config\"\n\n\t\"sigs.k8s.io/yaml\"\n)\n\nvar (\n\tinputFile = flag.String(\"input\", \"\", \"path to robots.txt file (use - for stdin)\")\n\toutputFile = flag.String(\"output\", \"\", \"output file path (use - for stdout, defaults to stdout)\")\n\toutputFormat = flag.String(\"format\", \"yaml\", \"output format: yaml or json\")\n\tbaseAction = flag.String(\"action\", \"CHALLENGE\", \"default action for disallowed paths: ALLOW, DENY, CHALLENGE, WEIGH\")\n\tcrawlDelay = flag.Int(\"crawl-delay-weight\", 0, \"if > 0, add weight adjustment for crawl-delay (difficulty adjustment)\")\n\tpolicyName = flag.String(\"name\", \"robots-txt-policy\", \"name for the generated policy\")\n\tuserAgentDeny = flag.String(\"deny-user-agents\", \"DENY\", \"action for specifically blocked user agents: DENY, CHALLENGE\")\n\thelpFlag = flag.Bool(\"help\", false, \"show help\")\n)\n\ntype RobotsRule struct {\n\tUserAgents []string\n\tDisallows []string\n\tAllows []string\n\tCrawlDelay int\n\tIsBlacklist bool // true if this is a specifically denied user agent\n}\n\ntype AnubisRule struct {\n\tExpression *config.ExpressionOrList `yaml:\"expression,omitempty\" json:\"expression,omitempty\"`\n\tChallenge *config.ChallengeRules `yaml:\"challenge,omitempty\" json:\"challenge,omitempty\"`\n\tWeight *config.Weight `yaml:\"weight,omitempty\" json:\"weight,omitempty\"`\n\tName string `yaml:\"name\" json:\"name\"`\n\tAction string `yaml:\"action\" json:\"action\"`\n}\n\nfunc init() {\n\tflag.Usage = func() {\n\t\tfmt.Fprintf(os.Stderr, \"Usage of %s:\\n\", os.Args[0])\n\t\tfmt.Fprintf(os.Stderr, \"%s [options] -input \\n\\n\", os.Args[0])\n\t\tflag.PrintDefaults()\n\t\tfmt.Fprintln(os.Stderr, \"\\nExamples:\")\n\t\tfmt.Fprintln(os.Stderr, \" # Convert local robots.txt file\")\n\t\tfmt.Fprintln(os.Stderr, \" robots2policy -input robots.txt -output policy.yaml\")\n\t\tfmt.Fprintln(os.Stderr, \"\")\n\t\tfmt.Fprintln(os.Stderr, \" # Convert from URL\")\n\t\tfmt.Fprintln(os.Stderr, \" robots2policy -input https://example.com/robots.txt -format json\")\n\t\tfmt.Fprintln(os.Stderr, \"\")\n\t\tfmt.Fprintln(os.Stderr, \" # Read from stdin, write to stdout\")\n\t\tfmt.Fprintln(os.Stderr, \" curl https://example.com/robots.txt | robots2policy -input -\")\n\t\tos.Exit(2)\n\t}\n}\n\nfunc main() {\n\tflag.Parse()\n\n\tif len(flag.Args()) > 0 || *helpFlag || *inputFile == \"\" {\n\t\tflag.Usage()\n\t}\n\n\t// Read robots.txt\n\tvar input io.Reader\n\tif *inputFile == \"-\" {\n\t\tinput = os.Stdin\n\t} else if strings.HasPrefix(*inputFile, \"http://\") || strings.HasPrefix(*inputFile, \"https://\") {\n\t\tresp, err := http.Get(*inputFile)\n\t\tif err != nil {\n\t\t\tlog.Fatalf(\"failed to fetch robots.txt from URL: %v\", err)\n\t\t}\n\t\tdefer resp.Body.Close()\n\t\tinput = resp.Body\n\t} else {\n\t\tfile, err := os.Open(*inputFile)\n\t\tif err != nil {\n\t\t\tlog.Fatalf(\"failed to open input file: %v\", err)\n\t\t}\n\t\tdefer file.Close()\n\t\tinput = file\n\t}\n\n\t// Parse robots.txt\n\trules, err := parseRobotsTxt(input)\n\tif err != nil {\n\t\tlog.Fatalf(\"failed to parse robots.txt: %v\", err)\n\t}\n\n\t// Convert to Anubis rules\n\tanubisRules := convertToAnubisRules(rules)\n\n\t// Check if any rules were generated\n\tif len(anubisRules) == 0 {\n\t\tlog.Fatal(\"no valid rules generated from robots.txt - file may be empty or contain no disallow directives\")\n\t}\n\n\t// Generate output\n\tvar output []byte\n\tswitch strings.ToLower(*outputFormat) {\n\tcase \"yaml\":\n\t\toutput, err = yaml.Marshal(anubisRules)\n\tcase \"json\":\n\t\toutput, err = json.MarshalIndent(anubisRules, \"\", \" \")\n\tdefault:\n\t\tlog.Fatalf(\"unsupported output format: %s (use yaml or json)\", *outputFormat)\n\t}\n\n\tif err != nil {\n\t\tlog.Fatalf(\"failed to marshal output: %v\", err)\n\t}\n\n\t// Write output\n\tif *outputFile == \"\" || *outputFile == \"-\" {\n\t\tfmt.Print(string(output))\n\t} else {\n\t\terr = os.WriteFile(*outputFile, output, 0644)\n\t\tif err != nil {\n\t\t\tlog.Fatalf(\"failed to write output file: %v\", err)\n\t\t}\n\t\tfmt.Printf(\"Generated Anubis policy written to %s\\n\", *outputFile)\n\t}\n}\n\nfunc createRuleFromAccumulated(userAgents, disallows, allows []string, crawlDelay int) RobotsRule {\n\trule := RobotsRule{\n\t\tUserAgents: make([]string, len(userAgents)),\n\t\tDisallows: make([]string, len(disallows)),\n\t\tAllows: make([]string, len(allows)),\n\t\tCrawlDelay: crawlDelay,\n\t}\n\tcopy(rule.UserAgents, userAgents)\n\tcopy(rule.Disallows, disallows)\n\tcopy(rule.Allows, allows)\n\treturn rule\n}\n\nfunc parseRobotsTxt(input io.Reader) ([]RobotsRule, error) {\n\tscanner := bufio.NewScanner(input)\n\tvar rules []RobotsRule\n\tvar currentUserAgents []string\n\tvar currentDisallows []string\n\tvar currentAllows []string\n\tvar currentCrawlDelay int\n\n\tfor scanner.Scan() {\n\t\tline := strings.TrimSpace(scanner.Text())\n\n\t\t// Skip empty lines and comments\n\t\tif line == \"\" || strings.HasPrefix(line, \"#\") {\n\t\t\tcontinue\n\t\t}\n\n\t\t// Split on first colon\n\t\tparts := strings.SplitN(line, \":\", 2)\n\t\tif len(parts) != 2 {\n\t\t\tcontinue\n\t\t}\n\n\t\tdirective := strings.TrimSpace(strings.ToLower(parts[0]))\n\t\tvalue := strings.TrimSpace(parts[1])\n\n\t\tswitch directive {\n\t\tcase \"user-agent\":\n\t\t\t// If we have accumulated rules with directives and encounter a new user-agent,\n\t\t\t// flush the current rules\n\t\t\tif len(currentUserAgents) > 0 && (len(currentDisallows) > 0 || len(currentAllows) > 0 || currentCrawlDelay > 0) {\n\t\t\t\trule := createRuleFromAccumulated(currentUserAgents, currentDisallows, currentAllows, currentCrawlDelay)\n\t\t\t\trules = append(rules, rule)\n\t\t\t\t// Reset for next group\n\t\t\t\tcurrentUserAgents = nil\n\t\t\t\tcurrentDisallows = nil\n\t\t\t\tcurrentAllows = nil\n\t\t\t\tcurrentCrawlDelay = 0\n\t\t\t}\n\t\t\tcurrentUserAgents = append(currentUserAgents, value)\n\n\t\tcase \"disallow\":\n\t\t\tif len(currentUserAgents) > 0 && value != \"\" {\n\t\t\t\tcurrentDisallows = append(currentDisallows, value)\n\t\t\t}\n\n\t\tcase \"allow\":\n\t\t\tif len(currentUserAgents) > 0 && value != \"\" {\n\t\t\t\tcurrentAllows = append(currentAllows, value)\n\t\t\t}\n\n\t\tcase \"crawl-delay\":\n\t\t\tif len(currentUserAgents) > 0 {\n\t\t\t\tif delay, err := parseIntSafe(value); err == nil {\n\t\t\t\t\tcurrentCrawlDelay = delay\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\n\t// Don't forget the last group of rules\n\tif len(currentUserAgents) > 0 {\n\t\trule := createRuleFromAccumulated(currentUserAgents, currentDisallows, currentAllows, currentCrawlDelay)\n\t\trules = append(rules, rule)\n\t}\n\n\t// Mark blacklisted user agents (those with \"Disallow: /\")\n\tfor i := range rules {\n\t\tif slices.Contains(rules[i].Disallows, \"/\") {\n\t\t\trules[i].IsBlacklist = true\n\t\t}\n\t}\n\n\treturn rules, scanner.Err()\n}\n\nfunc parseIntSafe(s string) (int, error) {\n\tvar result int\n\t_, err := fmt.Sscanf(s, \"%d\", &result)\n\treturn result, err\n}\n\nfunc convertToAnubisRules(robotsRules []RobotsRule) []AnubisRule {\n\tvar anubisRules []AnubisRule\n\truleCounter := 0\n\n\t// Process each robots rule individually\n\tfor _, robotsRule := range robotsRules {\n\t\tuserAgents := robotsRule.UserAgents\n\n\t\t// Handle crawl delay\n\t\tif robotsRule.CrawlDelay > 0 && *crawlDelay > 0 {\n\t\t\truleCounter++\n\t\t\trule := AnubisRule{\n\t\t\t\tName: fmt.Sprintf(\"%s-crawl-delay-%d\", *policyName, ruleCounter),\n\t\t\t\tAction: \"WEIGH\",\n\t\t\t\tWeight: &config.Weight{Adjust: *crawlDelay},\n\t\t\t}\n\n\t\t\tif len(userAgents) == 1 && userAgents[0] == \"*\" {\n\t\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\t\tAll: []string{\"true\"}, // Always applies\n\t\t\t\t}\n\t\t\t} else if len(userAgents) == 1 {\n\t\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\t\tAll: []string{fmt.Sprintf(\"userAgent.contains(%q)\", userAgents[0])},\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\t// Multiple user agents - use any block\n\t\t\t\tvar expressions []string\n\t\t\t\tfor _, ua := range userAgents {\n\t\t\t\t\tif ua == \"*\" {\n\t\t\t\t\t\texpressions = append(expressions, \"true\")\n\t\t\t\t\t} else {\n\t\t\t\t\t\texpressions = append(expressions, fmt.Sprintf(\"userAgent.contains(%q)\", ua))\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\t\tAny: expressions,\n\t\t\t\t}\n\t\t\t}\n\t\t\tanubisRules = append(anubisRules, rule)\n\t\t}\n\n\t\t// Handle blacklisted user agents\n\t\tif robotsRule.IsBlacklist {\n\t\t\truleCounter++\n\t\t\trule := AnubisRule{\n\t\t\t\tName: fmt.Sprintf(\"%s-blacklist-%d\", *policyName, ruleCounter),\n\t\t\t\tAction: *userAgentDeny,\n\t\t\t}\n\n\t\t\tif len(userAgents) == 1 {\n\t\t\t\tuserAgent := userAgents[0]\n\t\t\t\tif userAgent == \"*\" {\n\t\t\t\t\t// This would block everything - convert to a weight adjustment instead\n\t\t\t\t\trule.Name = fmt.Sprintf(\"%s-global-restriction-%d\", *policyName, ruleCounter)\n\t\t\t\t\trule.Action = \"WEIGH\"\n\t\t\t\t\trule.Weight = &config.Weight{Adjust: 20} // Increase difficulty significantly\n\t\t\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\t\t\tAll: []string{\"true\"}, // Always applies\n\t\t\t\t\t}\n\t\t\t\t} else {\n\t\t\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\t\t\tAll: []string{fmt.Sprintf(\"userAgent.contains(%q)\", userAgent)},\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\t// Multiple user agents - use any block\n\t\t\t\tvar expressions []string\n\t\t\t\tfor _, ua := range userAgents {\n\t\t\t\t\tif ua == \"*\" {\n\t\t\t\t\t\texpressions = append(expressions, \"true\")\n\t\t\t\t\t} else {\n\t\t\t\t\t\texpressions = append(expressions, fmt.Sprintf(\"userAgent.contains(%q)\", ua))\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\t\tAny: expressions,\n\t\t\t\t}\n\t\t\t}\n\t\t\tanubisRules = append(anubisRules, rule)\n\t\t}\n\n\t\t// Handle specific disallow rules\n\t\tfor _, disallow := range robotsRule.Disallows {\n\t\t\tif disallow == \"/\" {\n\t\t\t\tcontinue // Already handled as blacklist above\n\t\t\t}\n\n\t\t\truleCounter++\n\t\t\trule := AnubisRule{\n\t\t\t\tName: fmt.Sprintf(\"%s-disallow-%d\", *policyName, ruleCounter),\n\t\t\t\tAction: *baseAction,\n\t\t\t}\n\n\t\t\t// Build CEL expression\n\t\t\tvar conditions []string\n\n\t\t\t// Add user agent conditions\n\t\t\tif len(userAgents) == 1 && userAgents[0] == \"*\" {\n\t\t\t\t// Wildcard user agent - no user agent condition needed\n\t\t\t} else if len(userAgents) == 1 {\n\t\t\t\tconditions = append(conditions, fmt.Sprintf(\"userAgent.contains(%q)\", userAgents[0]))\n\t\t\t} else {\n\t\t\t\t// For multiple user agents, we need to use a more complex expression\n\t\t\t\t// This is a limitation - we can't easily combine any for user agents with all for path\n\t\t\t\t// So we'll create separate rules for each user agent\n\t\t\t\tfor _, ua := range userAgents {\n\t\t\t\t\tif ua == \"*\" {\n\t\t\t\t\t\tcontinue // Skip wildcard as it's handled separately\n\t\t\t\t\t}\n\t\t\t\t\truleCounter++\n\t\t\t\t\tsubRule := AnubisRule{\n\t\t\t\t\t\tName: fmt.Sprintf(\"%s-disallow-%d\", *policyName, ruleCounter),\n\t\t\t\t\t\tAction: *baseAction,\n\t\t\t\t\t\tExpression: &config.ExpressionOrList{\n\t\t\t\t\t\t\tAll: []string{\n\t\t\t\t\t\t\t\tfmt.Sprintf(\"userAgent.contains(%q)\", ua),\n\t\t\t\t\t\t\t\tbuildPathCondition(disallow),\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t},\n\t\t\t\t\t}\n\t\t\t\t\tanubisRules = append(anubisRules, subRule)\n\t\t\t\t}\n\t\t\t\tcontinue\n\t\t\t}\n\n\t\t\t// Add path condition\n\t\t\tpathCondition := buildPathCondition(disallow)\n\t\t\tconditions = append(conditions, pathCondition)\n\n\t\t\trule.Expression = &config.ExpressionOrList{\n\t\t\t\tAll: conditions,\n\t\t\t}\n\n\t\t\tanubisRules = append(anubisRules, rule)\n\t\t}\n\t}\n\n\treturn anubisRules\n}\n\nfunc buildPathCondition(robotsPath string) string {\n\t// Handle wildcards in robots.txt paths\n\tif strings.Contains(robotsPath, \"*\") || strings.Contains(robotsPath, \"?\") {\n\t\t// Convert robots.txt wildcards to regex\n\t\tregex := regexp.QuoteMeta(robotsPath)\n\t\tregex = strings.ReplaceAll(regex, `\\*`, `.*`) // * becomes .*\n\t\tregex = strings.ReplaceAll(regex, `\\?`, `.`) // ? becomes .\n\t\tregex = \"^\" + regex\n\t\treturn fmt.Sprintf(\"path.matches(%q)\", regex)\n\t}\n\n\t// Simple prefix match for most cases\n\treturn fmt.Sprintf(\"path.startsWith(%q)\", robotsPath)\n}\n"
},
{
"path": "cmd/robots2policy/robots2policy_test.go",
"content": "package main\n\nimport (\n\t\"encoding/json\"\n\t\"fmt\"\n\t\"os\"\n\t\"path/filepath\"\n\t\"reflect\"\n\t\"strings\"\n\t\"testing\"\n\n\t\"gopkg.in/yaml.v3\"\n)\n\ntype TestCase struct {\n\tname string\n\trobotsFile string\n\texpectedFile string\n\toptions TestOptions\n}\n\ntype TestOptions struct {\n\tformat string\n\taction string\n\tpolicyName string\n\tdeniedAction string\n\tcrawlDelayWeight int\n}\n\nfunc TestDataFileConversion(t *testing.T) {\n\n\ttestCases := []TestCase{\n\t\t{\n\t\t\tname: \"simple_default\",\n\t\t\trobotsFile: \"simple.robots.txt\",\n\t\t\texpectedFile: \"simple.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\"},\n\t\t},\n\t\t{\n\t\t\tname: \"simple_json\",\n\t\t\trobotsFile: \"simple.robots.txt\",\n\t\t\texpectedFile: \"simple.json\",\n\t\t\toptions: TestOptions{format: \"json\"},\n\t\t},\n\t\t{\n\t\t\tname: \"simple_deny_action\",\n\t\t\trobotsFile: \"simple.robots.txt\",\n\t\t\texpectedFile: \"deny-action.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\", action: \"DENY\"},\n\t\t},\n\t\t{\n\t\t\tname: \"simple_custom_name\",\n\t\t\trobotsFile: \"simple.robots.txt\",\n\t\t\texpectedFile: \"custom-name.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\", policyName: \"my-custom-policy\"},\n\t\t},\n\t\t{\n\t\t\tname: \"blacklist_with_crawl_delay\",\n\t\t\trobotsFile: \"blacklist.robots.txt\",\n\t\t\texpectedFile: \"blacklist.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\", crawlDelayWeight: 3},\n\t\t},\n\t\t{\n\t\t\tname: \"wildcards\",\n\t\t\trobotsFile: \"wildcards.robots.txt\",\n\t\t\texpectedFile: \"wildcards.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\"},\n\t\t},\n\t\t{\n\t\t\tname: \"empty_file\",\n\t\t\trobotsFile: \"empty.robots.txt\",\n\t\t\texpectedFile: \"empty.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\"},\n\t\t},\n\t\t{\n\t\t\tname: \"complex_scenario\",\n\t\t\trobotsFile: \"complex.robots.txt\",\n\t\t\texpectedFile: \"complex.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\", crawlDelayWeight: 5},\n\t\t},\n\t\t{\n\t\t\tname: \"consecutive_user_agents\",\n\t\t\trobotsFile: \"consecutive.robots.txt\",\n\t\t\texpectedFile: \"consecutive.yaml\",\n\t\t\toptions: TestOptions{format: \"yaml\", crawlDelayWeight: 3},\n\t\t},\n\t}\n\n\tfor _, tc := range testCases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\trobotsPath := filepath.Join(\"testdata\", tc.robotsFile)\n\t\t\texpectedPath := filepath.Join(\"testdata\", tc.expectedFile)\n\n\t\t\t// Read robots.txt input\n\t\t\trobotsFile, err := os.Open(robotsPath)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to open robots file %s: %v\", robotsPath, err)\n\t\t\t}\n\t\t\tdefer robotsFile.Close()\n\n\t\t\t// Parse robots.txt\n\t\t\trules, err := parseRobotsTxt(robotsFile)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to parse robots.txt: %v\", err)\n\t\t\t}\n\n\t\t\t// Set test options\n\t\t\toldFormat := *outputFormat\n\t\t\toldAction := *baseAction\n\t\t\toldCrawlDelay := *crawlDelay\n\t\t\toldPolicyName := *policyName\n\t\t\toldDeniedAction := *userAgentDeny\n\n\t\t\tif tc.options.format != \"\" {\n\t\t\t\t*outputFormat = tc.options.format\n\t\t\t}\n\t\t\tif tc.options.action != \"\" {\n\t\t\t\t*baseAction = tc.options.action\n\t\t\t}\n\t\t\tif tc.options.crawlDelayWeight > 0 {\n\t\t\t\t*crawlDelay = tc.options.crawlDelayWeight\n\t\t\t}\n\t\t\tif tc.options.policyName != \"\" {\n\t\t\t\t*policyName = tc.options.policyName\n\t\t\t}\n\t\t\tif tc.options.deniedAction != \"\" {\n\t\t\t\t*userAgentDeny = tc.options.deniedAction\n\t\t\t}\n\n\t\t\t// Restore options after test\n\t\t\tdefer func() {\n\t\t\t\t*outputFormat = oldFormat\n\t\t\t\t*baseAction = oldAction\n\t\t\t\t*crawlDelay = oldCrawlDelay\n\t\t\t\t*policyName = oldPolicyName\n\t\t\t\t*userAgentDeny = oldDeniedAction\n\t\t\t}()\n\n\t\t\t// Convert to Anubis rules\n\t\t\tanubisRules := convertToAnubisRules(rules)\n\n\t\t\t// Generate output\n\t\t\tvar actualOutput []byte\n\t\t\tswitch strings.ToLower(*outputFormat) {\n\t\t\tcase \"yaml\":\n\t\t\t\tactualOutput, err = yaml.Marshal(anubisRules)\n\t\t\tcase \"json\":\n\t\t\t\tactualOutput, err = json.MarshalIndent(anubisRules, \"\", \" \")\n\t\t\t}\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to marshal output: %v\", err)\n\t\t\t}\n\n\t\t\t// Read expected output\n\t\t\texpectedOutput, err := os.ReadFile(expectedPath)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to read expected file %s: %v\", expectedPath, err)\n\t\t\t}\n\n\t\t\tif strings.ToLower(*outputFormat) == \"yaml\" {\n\t\t\t\tvar actualData []any\n\t\t\t\tvar expectedData []any\n\n\t\t\t\terr = yaml.Unmarshal(actualOutput, &actualData)\n\t\t\t\tif err != nil {\n\t\t\t\t\tt.Fatalf(\"Failed to unmarshal actual output: %v\", err)\n\t\t\t\t}\n\n\t\t\t\terr = yaml.Unmarshal(expectedOutput, &expectedData)\n\t\t\t\tif err != nil {\n\t\t\t\t\tt.Fatalf(\"Failed to unmarshal expected output: %v\", err)\n\t\t\t\t}\n\n\t\t\t\t// Compare data structures\n\t\t\t\tif !compareData(actualData, expectedData) {\n\t\t\t\t\tactualStr := strings.TrimSpace(string(actualOutput))\n\t\t\t\t\texpectedStr := strings.TrimSpace(string(expectedOutput))\n\t\t\t\t\tt.Errorf(\"Output mismatch for %s\\nExpected:\\n%s\\n\\nActual:\\n%s\", tc.name, expectedStr, actualStr)\n\t\t\t\t}\n\t\t\t} else {\n\t\t\t\tvar actualData []any\n\t\t\t\tvar expectedData []any\n\n\t\t\t\terr = json.Unmarshal(actualOutput, &actualData)\n\t\t\t\tif err != nil {\n\t\t\t\t\tt.Fatalf(\"Failed to unmarshal actual JSON output: %v\", err)\n\t\t\t\t}\n\n\t\t\t\terr = json.Unmarshal(expectedOutput, &expectedData)\n\t\t\t\tif err != nil {\n\t\t\t\t\tt.Fatalf(\"Failed to unmarshal expected JSON output: %v\", err)\n\t\t\t\t}\n\n\t\t\t\t// Compare data structures\n\t\t\t\tif !compareData(actualData, expectedData) {\n\t\t\t\t\tactualStr := strings.TrimSpace(string(actualOutput))\n\t\t\t\t\texpectedStr := strings.TrimSpace(string(expectedOutput))\n\t\t\t\t\tt.Errorf(\"Output mismatch for %s\\nExpected:\\n%s\\n\\nActual:\\n%s\", tc.name, expectedStr, actualStr)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestCaseInsensitiveParsing(t *testing.T) {\n\trobotsTxt := `User-Agent: *\nDisallow: /admin\nCrawl-Delay: 10\n\nUser-agent: TestBot\ndisallow: /test\ncrawl-delay: 5\n\nUSER-AGENT: UpperBot\nDISALLOW: /upper\nCRAWL-DELAY: 20`\n\n\treader := strings.NewReader(robotsTxt)\n\trules, err := parseRobotsTxt(reader)\n\tif err != nil {\n\t\tt.Fatalf(\"Failed to parse case-insensitive robots.txt: %v\", err)\n\t}\n\n\texpectedRules := 3\n\tif len(rules) != expectedRules {\n\t\tt.Errorf(\"Expected %d rules, got %d\", expectedRules, len(rules))\n\t}\n\n\t// Check that all crawl delays were parsed\n\tfor i, rule := range rules {\n\t\texpectedDelays := []int{10, 5, 20}\n\t\tif rule.CrawlDelay != expectedDelays[i] {\n\t\t\tt.Errorf(\"Rule %d: expected crawl delay %d, got %d\", i, expectedDelays[i], rule.CrawlDelay)\n\t\t}\n\t}\n}\n\nfunc TestVariousOutputFormats(t *testing.T) {\n\trobotsTxt := `User-agent: *\nDisallow: /admin`\n\n\treader := strings.NewReader(robotsTxt)\n\trules, err := parseRobotsTxt(reader)\n\tif err != nil {\n\t\tt.Fatalf(\"Failed to parse robots.txt: %v\", err)\n\t}\n\n\toldPolicyName := *policyName\n\t*policyName = \"test-policy\"\n\tdefer func() { *policyName = oldPolicyName }()\n\n\tanubisRules := convertToAnubisRules(rules)\n\n\t// Test YAML output\n\tyamlOutput, err := yaml.Marshal(anubisRules)\n\tif err != nil {\n\t\tt.Fatalf(\"Failed to marshal YAML: %v\", err)\n\t}\n\n\tif !strings.Contains(string(yamlOutput), \"name: test-policy-disallow-1\") {\n\t\tt.Errorf(\"YAML output doesn't contain expected rule name\")\n\t}\n\n\t// Test JSON output\n\tjsonOutput, err := json.MarshalIndent(anubisRules, \"\", \" \")\n\tif err != nil {\n\t\tt.Fatalf(\"Failed to marshal JSON: %v\", err)\n\t}\n\n\tif !strings.Contains(string(jsonOutput), `\"name\": \"test-policy-disallow-1\"`) {\n\t\tt.Errorf(\"JSON output doesn't contain expected rule name\")\n\t}\n}\n\nfunc TestDifferentActions(t *testing.T) {\n\trobotsTxt := `User-agent: *\nDisallow: /admin`\n\n\ttestActions := []string{\"ALLOW\", \"DENY\", \"CHALLENGE\", \"WEIGH\"}\n\n\tfor _, action := range testActions {\n\t\tt.Run(\"action_\"+action, func(t *testing.T) {\n\t\t\treader := strings.NewReader(robotsTxt)\n\t\t\trules, err := parseRobotsTxt(reader)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to parse robots.txt: %v\", err)\n\t\t\t}\n\n\t\t\toldAction := *baseAction\n\t\t\t*baseAction = action\n\t\t\tdefer func() { *baseAction = oldAction }()\n\n\t\t\tanubisRules := convertToAnubisRules(rules)\n\n\t\t\tif len(anubisRules) != 1 {\n\t\t\t\tt.Fatalf(\"Expected 1 rule, got %d\", len(anubisRules))\n\t\t\t}\n\n\t\t\tif anubisRules[0].Action != action {\n\t\t\t\tt.Errorf(\"Expected action %s, got %s\", action, anubisRules[0].Action)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestPolicyNaming(t *testing.T) {\n\trobotsTxt := `User-agent: *\nDisallow: /admin\nDisallow: /private\n\nUser-agent: BadBot\nDisallow: /`\n\n\ttestNames := []string{\"custom-policy\", \"my-rules\", \"site-protection\"}\n\n\tfor _, name := range testNames {\n\t\tt.Run(\"name_\"+name, func(t *testing.T) {\n\t\t\treader := strings.NewReader(robotsTxt)\n\t\t\trules, err := parseRobotsTxt(reader)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to parse robots.txt: %v\", err)\n\t\t\t}\n\n\t\t\toldName := *policyName\n\t\t\t*policyName = name\n\t\t\tdefer func() { *policyName = oldName }()\n\n\t\t\tanubisRules := convertToAnubisRules(rules)\n\n\t\t\t// Check that all rule names use the custom prefix\n\t\t\tfor _, rule := range anubisRules {\n\t\t\t\tif !strings.HasPrefix(rule.Name, name+\"-\") {\n\t\t\t\t\tt.Errorf(\"Rule name %s doesn't start with expected prefix %s-\", rule.Name, name)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestCrawlDelayWeights(t *testing.T) {\n\trobotsTxt := `User-agent: *\nDisallow: /admin\nCrawl-delay: 10\n\nUser-agent: SlowBot\nDisallow: /slow\nCrawl-delay: 60`\n\n\ttestWeights := []int{1, 5, 10, 25}\n\n\tfor _, weight := range testWeights {\n\t\tt.Run(fmt.Sprintf(\"weight_%d\", weight), func(t *testing.T) {\n\t\t\treader := strings.NewReader(robotsTxt)\n\t\t\trules, err := parseRobotsTxt(reader)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to parse robots.txt: %v\", err)\n\t\t\t}\n\n\t\t\toldWeight := *crawlDelay\n\t\t\t*crawlDelay = weight\n\t\t\tdefer func() { *crawlDelay = oldWeight }()\n\n\t\t\tanubisRules := convertToAnubisRules(rules)\n\n\t\t\t// Count weight rules and verify they have correct weight\n\t\t\tweightRules := 0\n\t\t\tfor _, rule := range anubisRules {\n\t\t\t\tif rule.Action == \"WEIGH\" && rule.Weight != nil {\n\t\t\t\t\tweightRules++\n\t\t\t\t\tif rule.Weight.Adjust != weight {\n\t\t\t\t\t\tt.Errorf(\"Expected weight %d, got %d\", weight, rule.Weight.Adjust)\n\t\t\t\t\t}\n\t\t\t\t}\n\t\t\t}\n\n\t\t\texpectedWeightRules := 2 // One for *, one for SlowBot\n\t\t\tif weightRules != expectedWeightRules {\n\t\t\t\tt.Errorf(\"Expected %d weight rules, got %d\", expectedWeightRules, weightRules)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestBlacklistActions(t *testing.T) {\n\trobotsTxt := `User-agent: BadBot\nDisallow: /\n\nUser-agent: SpamBot\nDisallow: /`\n\n\ttestActions := []string{\"DENY\", \"CHALLENGE\"}\n\n\tfor _, action := range testActions {\n\t\tt.Run(\"blacklist_\"+action, func(t *testing.T) {\n\t\t\treader := strings.NewReader(robotsTxt)\n\t\t\trules, err := parseRobotsTxt(reader)\n\t\t\tif err != nil {\n\t\t\t\tt.Fatalf(\"Failed to parse robots.txt: %v\", err)\n\t\t\t}\n\n\t\t\toldAction := *userAgentDeny\n\t\t\t*userAgentDeny = action\n\t\t\tdefer func() { *userAgentDeny = oldAction }()\n\n\t\t\tanubisRules := convertToAnubisRules(rules)\n\n\t\t\t// All rules should be blacklist rules with the specified action\n\t\t\tfor _, rule := range anubisRules {\n\t\t\t\tif !strings.Contains(rule.Name, \"blacklist\") {\n\t\t\t\t\tt.Errorf(\"Expected blacklist rule, got %s\", rule.Name)\n\t\t\t\t}\n\t\t\t\tif rule.Action != action {\n\t\t\t\t\tt.Errorf(\"Expected action %s, got %s\", action, rule.Action)\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t}\n}\n\n// compareData performs a deep comparison of two data structures,\n// ignoring differences that are semantically equivalent in YAML/JSON\nfunc compareData(actual, expected any) bool {\n\treturn reflect.DeepEqual(actual, expected)\n}\n"
},
{
"path": "cmd/robots2policy/testdata/blacklist.robots.txt",
"content": "# Test with blacklisted user agents\nUser-agent: *\nDisallow: /admin\nCrawl-delay: 10\n\nUser-agent: BadBot\nDisallow: /\n\nUser-agent: SpamBot\nDisallow: /\nCrawl-delay: 60\n\nUser-agent: Googlebot\nDisallow: /search\nCrawl-delay: 5"
},
{
"path": "cmd/robots2policy/testdata/blacklist.yaml",
"content": "- action: WEIGH\n expression: \"true\"\n name: robots-txt-policy-crawl-delay-1\n weight:\n adjust: 3\n- action: CHALLENGE\n expression: path.startsWith(\"/admin\")\n name: robots-txt-policy-disallow-2\n- action: DENY\n expression: userAgent.contains(\"BadBot\")\n name: robots-txt-policy-blacklist-3\n- action: WEIGH\n expression: userAgent.contains(\"SpamBot\")\n name: robots-txt-policy-crawl-delay-4\n weight:\n adjust: 3\n- action: DENY\n expression: userAgent.contains(\"SpamBot\")\n name: robots-txt-policy-blacklist-5\n- action: WEIGH\n expression: userAgent.contains(\"Googlebot\")\n name: robots-txt-policy-crawl-delay-6\n weight:\n adjust: 3\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"Googlebot\")\n - path.startsWith(\"/search\")\n name: robots-txt-policy-disallow-7\n"
},
{
"path": "cmd/robots2policy/testdata/complex.robots.txt",
"content": "# Complex real-world example\nUser-agent: *\nDisallow: /admin/\nDisallow: /private/\nDisallow: /api/internal/\nAllow: /api/public/\nCrawl-delay: 5\n\nUser-agent: Googlebot\nDisallow: /search/\nAllow: /api/\nCrawl-delay: 2\n\nUser-agent: Bingbot\nDisallow: /search/\nDisallow: /admin/\nCrawl-delay: 10\n\nUser-agent: BadBot\nDisallow: /\n\nUser-agent: SeoBot\nDisallow: /\nCrawl-delay: 300\n\n# Test with various patterns\nUser-agent: TestBot\nDisallow: /*/admin\nDisallow: /temp*.html\nDisallow: /file?.log"
},
{
"path": "cmd/robots2policy/testdata/complex.yaml",
"content": "- action: WEIGH\n expression: \"true\"\n name: robots-txt-policy-crawl-delay-1\n weight:\n adjust: 5\n- action: CHALLENGE\n expression: path.startsWith(\"/admin/\")\n name: robots-txt-policy-disallow-2\n- action: CHALLENGE\n expression: path.startsWith(\"/private/\")\n name: robots-txt-policy-disallow-3\n- action: CHALLENGE\n expression: path.startsWith(\"/api/internal/\")\n name: robots-txt-policy-disallow-4\n- action: WEIGH\n expression: userAgent.contains(\"Googlebot\")\n name: robots-txt-policy-crawl-delay-5\n weight:\n adjust: 5\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"Googlebot\")\n - path.startsWith(\"/search/\")\n name: robots-txt-policy-disallow-6\n- action: WEIGH\n expression: userAgent.contains(\"Bingbot\")\n name: robots-txt-policy-crawl-delay-7\n weight:\n adjust: 5\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"Bingbot\")\n - path.startsWith(\"/search/\")\n name: robots-txt-policy-disallow-8\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"Bingbot\")\n - path.startsWith(\"/admin/\")\n name: robots-txt-policy-disallow-9\n- action: DENY\n expression: userAgent.contains(\"BadBot\")\n name: robots-txt-policy-blacklist-10\n- action: WEIGH\n expression: userAgent.contains(\"SeoBot\")\n name: robots-txt-policy-crawl-delay-11\n weight:\n adjust: 5\n- action: DENY\n expression: userAgent.contains(\"SeoBot\")\n name: robots-txt-policy-blacklist-12\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"TestBot\")\n - path.matches(\"^/.*/admin\")\n name: robots-txt-policy-disallow-13\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"TestBot\")\n - path.matches(\"^/temp.*\\\\.html\")\n name: robots-txt-policy-disallow-14\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"TestBot\")\n - path.matches(\"^/file.\\\\.log\")\n name: robots-txt-policy-disallow-15\n"
},
{
"path": "cmd/robots2policy/testdata/consecutive.robots.txt",
"content": "# Test consecutive user agents that should be grouped into any: blocks\nUser-agent: *\nDisallow: /admin\nCrawl-delay: 10\n\n# Multiple consecutive user agents - should be grouped\nUser-agent: BadBot\nUser-agent: SpamBot\nUser-agent: EvilBot\nDisallow: /\n\n# Single user agent - should be separate\nUser-agent: GoodBot\nDisallow: /private\n\n# Multiple consecutive user agents with crawl delay\nUser-agent: SlowBot1\nUser-agent: SlowBot2\nCrawl-delay: 5\n\n# Multiple consecutive user agents with specific path\nUser-agent: SearchBot1\nUser-agent: SearchBot2\nUser-agent: SearchBot3\nDisallow: /search "
},
{
"path": "cmd/robots2policy/testdata/consecutive.yaml",
"content": "- action: WEIGH\n expression: \"true\"\n name: robots-txt-policy-crawl-delay-1\n weight:\n adjust: 3\n- action: CHALLENGE\n expression: path.startsWith(\"/admin\")\n name: robots-txt-policy-disallow-2\n- action: DENY\n expression:\n any:\n - userAgent.contains(\"BadBot\")\n - userAgent.contains(\"SpamBot\")\n - userAgent.contains(\"EvilBot\")\n name: robots-txt-policy-blacklist-3\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"GoodBot\")\n - path.startsWith(\"/private\")\n name: robots-txt-policy-disallow-4\n- action: WEIGH\n expression:\n any:\n - userAgent.contains(\"SlowBot1\")\n - userAgent.contains(\"SlowBot2\")\n name: robots-txt-policy-crawl-delay-5\n weight:\n adjust: 3\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"SearchBot1\")\n - path.startsWith(\"/search\")\n name: robots-txt-policy-disallow-7\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"SearchBot2\")\n - path.startsWith(\"/search\")\n name: robots-txt-policy-disallow-8\n- action: CHALLENGE\n expression:\n all:\n - userAgent.contains(\"SearchBot3\")\n - path.startsWith(\"/search\")\n name: robots-txt-policy-disallow-9\n"
},
{
"path": "cmd/robots2policy/testdata/custom-name.yaml",
"content": "- action: CHALLENGE\n expression: path.startsWith(\"/admin/\")\n name: my-custom-policy-disallow-1\n- action: CHALLENGE\n expression: path.startsWith(\"/private\")\n name: my-custom-policy-disallow-2\n"
},
{
"path": "cmd/robots2policy/testdata/deny-action.yaml",
"content": "- action: DENY\n expression: path.startsWith(\"/admin/\")\n name: robots-txt-policy-disallow-1\n- action: DENY\n expression: path.startsWith(\"/private\")\n name: robots-txt-policy-disallow-2\n"
},
{
"path": "cmd/robots2policy/testdata/empty.robots.txt",
"content": "# Empty robots.txt (comments only)\n# No actual rules"
},
{
"path": "cmd/robots2policy/testdata/empty.yaml",
"content": "[]\n"
},
{
"path": "cmd/robots2policy/testdata/simple.json",
"content": "[\n {\n \"expression\": \"path.startsWith(\\\"/admin/\\\")\",\n \"name\": \"robots-txt-policy-disallow-1\",\n \"action\": \"CHALLENGE\"\n },\n {\n \"expression\": \"path.startsWith(\\\"/private\\\")\",\n \"name\": \"robots-txt-policy-disallow-2\",\n \"action\": \"CHALLENGE\"\n }\n]\n"
},
{
"path": "cmd/robots2policy/testdata/simple.robots.txt",
"content": "# Simple robots.txt test\nUser-agent: *\nDisallow: /admin/\nDisallow: /private\nAllow: /public"
},
{
"path": "cmd/robots2policy/testdata/simple.yaml",
"content": "- action: CHALLENGE\n expression: path.startsWith(\"/admin/\")\n name: robots-txt-policy-disallow-1\n- action: CHALLENGE\n expression: path.startsWith(\"/private\")\n name: robots-txt-policy-disallow-2\n"
},
{
"path": "cmd/robots2policy/testdata/wildcards.robots.txt",
"content": "# Test wildcard patterns\nUser-agent: *\nDisallow: /search*\nDisallow: /*/private\nDisallow: /file?.txt\nDisallow: /admin/*?action=delete"
},
{
"path": "cmd/robots2policy/testdata/wildcards.yaml",
"content": "- action: CHALLENGE\n expression: path.matches(\"^/search.*\")\n name: robots-txt-policy-disallow-1\n- action: CHALLENGE\n expression: path.matches(\"^/.*/private\")\n name: robots-txt-policy-disallow-2\n- action: CHALLENGE\n expression: path.matches(\"^/file.\\\\.txt\")\n name: robots-txt-policy-disallow-3\n- action: CHALLENGE\n expression: path.matches(\"^/admin/.*.action=delete\")\n name: robots-txt-policy-disallow-4\n"
},
{
"path": "data/apps/allow-api-routes.yaml",
"content": "- name: allow-api-routes\n action: ALLOW\n expression:\n all:\n - '!(method == \"HEAD\" || method == \"GET\")'\n - path.startsWith(\"/api/\")\n"
},
{
"path": "data/apps/bookstack-saml.yaml",
"content": "# Make SASL login work on bookstack with Anubis\n# https://www.bookstackapp.com/docs/admin/saml2-auth/\n- name: allow-bookstack-sasl-login-routes\n action: ALLOW\n expression:\n all:\n - 'method == \"POST\"'\n - path.startsWith(\"/saml2/acs\")\n- name: allow-bookstack-sasl-metadata-routes\n action: ALLOW\n expression:\n all:\n - 'method == \"GET\"'\n - path.startsWith(\"/saml2/metadata\")\n- name: allow-bookstack-sasl-logout-routes\n action: ALLOW\n expression:\n all:\n - 'method == \"GET\"'\n - path.startsWith(\"/saml2/sls\")\n"
},
{
"path": "data/apps/gitea-rss-feeds.yaml",
"content": "# By Aibrew: https://github.com/TecharoHQ/anubis/discussions/261#discussioncomment-12821065\n- name: gitea-feed-atom\n action: ALLOW\n path_regex: ^/[.A-Za-z0-9_-]{1,256}?[./A-Za-z0-9_-]*\\.atom$\n- name: gitea-feed-rss\n action: ALLOW\n path_regex: ^/[.A-Za-z0-9_-]{1,256}?[./A-Za-z0-9_-]*\\.rss$\n"
},
{
"path": "data/apps/qualys-ssl-labs.yml",
"content": "# This policy allows Qualys SSL Labs to fully work. (https://www.ssllabs.com/ssltest)\n# IP ranges are taken from: https://qualys.my.site.com/discussions/s/article/000005823\n- name: qualys-ssl-labs\n action: ALLOW\n remote_addresses:\n - 69.67.183.0/24\n - 2600:C02:1020:4202::/64\n - 2602:fdaa:c6:2::/64\n"
},
{
"path": "data/apps/searx-checker.yml",
"content": "# This policy allows SearXNG's instance tracker to work. (https://searx.space)\n# IPs are taken from `check.searx.space` DNS records.\n# https://toolbox.googleapps.com/apps/dig/#A/check.searx.space\n# https://toolbox.googleapps.com/apps/dig/#AAAA/check.searx.space\n- name: searx-checker\n action: ALLOW\n remote_addresses:\n - 167.235.158.251/32\n - 2a01:4f8:1c1c:8fc2::1/128\n"
},
{
"path": "data/botPolicies.yaml",
"content": "## Anubis has the ability to let you import snippets of configuration into the main\n## configuration file. This allows you to break up your config into smaller parts\n## that get logically assembled into one big file.\n##\n## Of note, a bot rule can either have inline bot configuration or import a\n## bot config snippet. You cannot do both in a single bot rule.\n##\n## Import paths can either be prefixed with (data) to import from the common/shared\n## rules in the data folder in the Anubis source tree or will point to absolute/relative\n## paths in your filesystem. If you don't have access to the Anubis source tree, check\n## /usr/share/docs/anubis/data or in the tarball you extracted Anubis from.\n\nbots:\n # You can import the entire default config with this macro:\n # - import: (data)/meta/default-config.yaml\n\n # Pathological bots to deny\n - # This correlates to data/bots/_deny-pathological.yaml in the source tree\n # https://github.com/TecharoHQ/anubis/blob/main/data/bots/_deny-pathological.yaml\n import: (data)/bots/_deny-pathological.yaml\n - import: (data)/bots/aggressive-brazilian-scrapers.yaml\n\n # Aggressively block AI/LLM related bots/agents by default\n - import: (data)/meta/ai-block-aggressive.yaml\n\n # Consider replacing the aggressive AI policy with more selective policies:\n # - import: (data)/meta/ai-block-moderate.yaml\n # - import: (data)/meta/ai-block-permissive.yaml\n\n # Search engine crawlers to allow, defaults to:\n # - Google (so they don't try to bypass Anubis)\n # - Apple\n # - Bing\n # - DuckDuckGo\n # - Qwant\n # - The Internet Archive\n # - Kagi\n # - Marginalia\n # - Mojeek\n - import: (data)/crawlers/_allow-good.yaml\n # Challenge Firefox AI previews\n - import: (data)/clients/x-firefox-ai.yaml\n\n # Allow common \"keeping the internet working\" routes (well-known, favicon, robots.txt)\n - import: (data)/common/keep-internet-working.yaml\n\n # # Punish any bot with \"bot\" in the user-agent string\n # # This is known to have a high false-positive rate, use at your own risk\n # - name: generic-bot-catchall\n # user_agent_regex: (?i:bot|crawler)\n # action: CHALLENGE\n # challenge:\n # difficulty: 16 # impossible\n # algorithm: slow # intentionally waste CPU cycles and time\n\n # Requires a subscription to Thoth to use, see\n # https://anubis.techaro.lol/docs/admin/thoth#geoip-based-filtering\n - name: countries-with-aggressive-scrapers\n action: WEIGH\n geoip:\n countries:\n - BR\n - CN\n weight:\n adjust: 10\n\n # Requires a subscription to Thoth to use, see\n # https://anubis.techaro.lol/docs/admin/thoth#asn-based-filtering\n - name: aggressive-asns-without-functional-abuse-contact\n action: WEIGH\n asns:\n match:\n - 13335 # Cloudflare\n - 136907 # Huawei Cloud\n - 45102 # Alibaba Cloud\n weight:\n adjust: 10\n\n # ## System load based checks.\n # # If the system is under high load, add weight.\n # - name: high-load-average\n # action: WEIGH\n # expression: load_1m >= 10.0 # make sure to end the load comparison in a .0\n # weight:\n # adjust: 20\n\n ## If your backend service is running on the same operating system as Anubis,\n ## you can uncomment this rule to make the challenge easier when the system is\n ## under low load.\n ##\n ## If it is not, remove weight.\n # - name: low-load-average\n # action: WEIGH\n # expression: load_15m <= 4.0 # make sure to end the load comparison in a .0\n # weight:\n # adjust: -10\n\n # Generic catchall rule\n - name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: WEIGH\n weight:\n adjust: 10\n\ndnsbl: false\n\n# #\n# impressum:\n# # Displayed at the bottom of every page rendered by Anubis.\n# footer: >-\n# This website is hosted by Zombocom. If you have any complaints or notes\n# about the service, please contact\n# contact@domainhere.example \n# and we will assist you as soon as possible.\n\n# # The imprint page that will be linked to at the footer of every Anubis page.\n# page:\n# # The HTML of the page\n# title: Imprint and Privacy Policy\n# # The HTML contents of the page. The exact contents of this page can\n# # and will vary by locale. Please consult with a lawyer if you are not\n# # sure what to put here\n# body: >-\n# <p>Last updated: June 2025</p>\n\n# <h2>Information that is gathered from visitors</h2>\n\n# <p>In common with other websites, log files are stored on the web server saving details such as the visitor's IP address, browser type, referring page and time of visit.</p>\n\n# <p>Cookies may be used to remember visitor preferences when interacting with the website.</p>\n\n# <p>Where registration is required, the visitor's email and a username will be stored on the server.</p>\n\n# <!-- ... -->\n\n# Open Graph passthrough configuration, see here for more information:\n# https://anubis.techaro.lol/docs/admin/configuration/open-graph/\nopenGraph:\n # Enables Open Graph passthrough\n enabled: false\n # Enables the use of the HTTP host in the cache key, this enables\n # caching metadata for multiple http hosts at once.\n considerHost: false\n # How long cached OpenGraph metadata should last in memory\n ttl: 24h\n # # If set, return these opengraph values instead of looking them up with\n # # the target service.\n # #\n # # Correlates to properties in https://ogp.me/\n # override:\n # # og:title is required, it is the title of the website\n # \"og:title\": \"Techaro Anubis\"\n # \"og:description\": >-\n # Anubis is a Web AI Firewall Utility that helps you fight the bots\n # away so that you can maintain uptime at work!\n # \"description\": >-\n # Anubis is a Web AI Firewall Utility that helps you fight the bots\n # away so that you can maintain uptime at work!\n\n# By default, send HTTP 200 back to clients that either get issued a challenge\n# or a denial. This seems weird, but this is load-bearing due to the fact that\n# the most aggressive scraper bots seem to really, really, want an HTTP 200 and\n# will stop sending requests once they get it.\nstatus_codes:\n CHALLENGE: 200\n DENY: 200\n\n# Anubis can store temporary data in one of a few backends. See the storage\n# backends section of the docs for more information:\n#\n# https://anubis.techaro.lol/docs/admin/policies#storage-backends\nstore:\n backend: memory\n parameters: {}\n\n# The weight thresholds for when to trigger individual challenges. Any\n# CHALLENGE will take precedence over this.\n#\n# A threshold has four configuration options:\n#\n# - name: the name that is reported down the stack and used for metrics\n# - expression: A CEL expression with the request weight in the variable\n# weight\n# - action: the Anubis action to apply, similar to in a bot policy\n# - challenge: which challenge to send to the user, similar to in a bot policy\n#\n# See https://anubis.techaro.lol/docs/admin/configuration/thresholds for more\n# information.\nthresholds:\n # By default Anubis ships with the following thresholds:\n - name: minimal-suspicion # This client is likely fine, its soul is lighter than a feather\n expression: weight <= 0 # a feather weighs zero units\n action: ALLOW # Allow the traffic through\n # For clients that had some weight reduced through custom rules, give them a\n # lightweight challenge.\n - name: mild-suspicion\n expression:\n all:\n - weight > 0\n - weight < 10\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/metarefresh\n algorithm: metarefresh\n difficulty: 1\n # For clients that are browser-like but have either gained points from custom rules or\n # report as a standard browser.\n - name: moderate-suspicion\n expression:\n all:\n - weight >= 10\n - weight < 20\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 2 # two leading zeros, very fast for most clients\n - name: mild-proof-of-work\n expression:\n all:\n - weight >= 20\n - weight < 30\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 4\n # For clients that are browser like and have gained many points from custom rules\n - name: extreme-suspicion\n expression: weight >= 30\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 6\n"
},
{
"path": "data/bots/_deny-pathological.yaml",
"content": "- import: (data)/bots/cloudflare-workers.yaml\n- import: (data)/bots/headless-browsers.yaml\n- import: (data)/bots/us-ai-scraper.yaml\n- import: (data)/bots/custom-async-http-client.yaml\n- import: (data)/crawlers/alibaba-cloud.yaml\n- import: (data)/crawlers/huawei-cloud.yaml\n"
},
{
"path": "data/bots/aggressive-brazilian-scrapers.yaml",
"content": "- name: deny-aggressive-brazilian-scrapers\n action: WEIGH\n weight:\n adjust: 20\n expression:\n any:\n # Internet Explorer should be out of support\n - userAgent.contains(\"MSIE\")\n # Trident is the Internet Explorer browser engine\n - userAgent.contains(\"Trident\")\n # Opera is a fork of chrome now\n - userAgent.contains(\"Presto\")\n # Windows CE is discontinued\n - userAgent.contains(\"Windows CE\")\n # Windows 95 is discontinued\n - userAgent.contains(\"Windows 95\")\n # Windows 98 is discontinued\n - userAgent.contains(\"Windows 98\")\n # Windows 9.x is discontinued\n - userAgent.contains(\"Win 9x\")\n # Amazon does not have an Alexa Toolbar.\n - userAgent.contains(\"Alexa Toolbar\")\n # This is not released, even Windows 11 calls itself Windows 10\n - userAgent.contains(\"Windows NT 11.0\")\n # iPods are not in common use\n - userAgent.contains(\"iPod\")\n"
},
{
"path": "data/bots/ai-catchall.yaml",
"content": "# Extensive list of AI-affiliated agents based on https://github.com/ai-robots-txt/ai.robots.txt\n# Add new/undocumented agents here. Where documentation exists, consider moving to dedicated policy files.\n# Notes on various agents:\n# - Amazonbot: Well documented, but they refuse to state which agent collects training data.\n# - anthropic-ai/Claude-Web: Undocumented by Anthropic. Possibly deprecated or hallucinations?\n# - Perplexity*: Well documented, but they refuse to state which agent collects training data.\n# Warning: May contain user agents that _must_ be blocked in robots.txt, or the opt-out will have no effect.\n- name: \"ai-catchall\"\n user_agent_regex: >-\n AI2Bot|Ai2Bot-Dolma|aiHitBot|Amazonbot|anthropic-ai|Brightbot 1.0|Bytespider|Claude-Web|cohere-ai|cohere-training-data-crawler|Cotoyogi|Crawlspace|Diffbot|DuckAssistBot|FacebookBot|Factset_spyderbot|FirecrawlAgent|FriendlyCrawler|Google-CloudVertexBot|GoogleOther|GoogleOther-Image|GoogleOther-Video|iaskspider/2.0|ICC-Crawler|ImagesiftBot|img2dataset|imgproxy|ISSCyberRiskCrawler|Kangaroo Bot|meta-externalagent|Meta-ExternalAgent|meta-externalfetcher|Meta-ExternalFetcher|NovaAct|omgili|omgilibot|Operator|PanguBot|Perplexity-User|PerplexityBot|PetalBot|QualifiedBot|Scrapy|SemrushBot-OCOB|SemrushBot-SWA|Sidetrade indexer bot|TikTokSpider|Timpibot|VelenPublicWebCrawler|Webzio-Extended|wpbot|YouBot\n action: DENY\n"
},
{
"path": "data/bots/ai-robots-txt.yaml",
"content": "# Warning: Contains user agents that _must_ be blocked in robots.txt, or the opt-out will have no effect.\n# Note: Blocks human-directed/non-training user agents\n#\n# CCBot is allowed because if Common Crawl is allowed, then scrapers don't need to scrape to get the data.\n- name: \"ai-robots-txt\"\n user_agent_regex: >-\n AddSearchBot|AI2Bot|Ai2Bot-Dolma|aiHitBot|Amazonbot|Andibot|anthropic-ai|Applebot|Applebot-Extended|Awario|bedrockbot|bigsur.ai|Brightbot 1.0|Bytespider|CCBot|ChatGPT Agent|ChatGPT-User|Claude-SearchBot|Claude-User|Claude-Web|ClaudeBot|CloudVertexBot|cohere-ai|cohere-training-data-crawler|Cotoyogi|Crawlspace|Datenbank Crawler|Devin|Diffbot|DuckAssistBot|Echobot Bot|EchoboxBot|FacebookBot|facebookexternalhit|Factset_spyderbot|FirecrawlAgent|FriendlyCrawler|Gemini-Deep-Research|Google-CloudVertexBot|Google-Extended|GoogleAgent-Mariner|GoogleOther|GoogleOther-Image|GoogleOther-Video|GPTBot|iaskspider/2.0|ICC-Crawler|ImagesiftBot|img2dataset|ISSCyberRiskCrawler|Kangaroo Bot|LinerBot|meta-externalagent|Meta-ExternalAgent|meta-externalfetcher|Meta-ExternalFetcher|MistralAI-User|MistralAI-User/1.0|MyCentralAIScraperBot|netEstate Imprint Crawler|NovaAct|OAI-SearchBot|omgili|omgilibot|OpenAI|Operator|PanguBot|Panscient|panscient.com|Perplexity-User|PerplexityBot|PetalBot|PhindBot|Poseidon Research Crawler|QualifiedBot|QuillBot|quillbot.com|SBIntuitionsBot|Scrapy|SemrushBot-OCOB|SemrushBot-SWA|Sidetrade indexer bot|Thinkbot|TikTokSpider|Timpibot|VelenPublicWebCrawler|WARDBot|Webzio-Extended|wpbot|YaK|YandexAdditional|YandexAdditionalBot|YouBot\n action: DENY\n"
},
{
"path": "data/bots/cloudflare-workers.yaml",
"content": "- name: cloudflare-workers\n headers_regex:\n CF-Worker: .*\n action: WEIGH\n weight:\n adjust: 15\n"
},
{
"path": "data/bots/custom-async-http-client.yaml",
"content": "- name: \"custom-async-http-client\"\n user_agent_regex: \"Custom-AsyncHttpClient\"\n action: WEIGH\n weight:\n adjust: 10\n"
},
{
"path": "data/bots/headless-browsers.yaml",
"content": "- name: lightpanda\n user_agent_regex: ^LightPanda/.*$\n action: DENY\n- name: headless-chrome\n user_agent_regex: HeadlessChrome\n action: DENY\n- name: headless-chromium\n user_agent_regex: HeadlessChromium\n action: DENY\n"
},
{
"path": "data/bots/irc-bots/archlinux-phrik.yaml",
"content": "# phrik in the Arch Linux IRC channels\n- name: archlinux-phrik\n action: ALLOW\n expression:\n all:\n - remoteAddress == \"159.69.213.214\" || remoteAddress == \"2a01:4f8:c2c:7bf4::1\"\n - userAgent == \"Mozilla/5.0 (compatible; utils.web Limnoria module)\"\n - '\"X-Http-Version\" in headers'\n - headers[\"X-Http-Version\"] == \"HTTP/1.1\"\n"
},
{
"path": "data/bots/irc-bots/gentoo-chat.yaml",
"content": "# chat in the gentoo IRC channels\n- name: gentoo-chat\n action: ALLOW\n expression:\n all:\n - remoteAddress == \"45.76.166.57\"\n - userAgent == \"Mozilla/5.0 (Linux x86_64; rv:76.0) Gecko/20100101 Firefox/76.0\"\n - '\"X-Http-Version\" in headers'\n - headers[\"X-Http-Version\"] == \"HTTP/1.1\"\n"
},
{
"path": "data/bots/us-ai-scraper.yaml",
"content": "- name: us-artificial-intelligence-scraper\n user_agent_regex: \\+https\\://github\\.com/US-Artificial-Intelligence/scraper\n action: DENY\n"
},
{
"path": "data/clients/ai.yaml",
"content": "# User agents that act on behalf of humans in AI tools, e.g. searching the web.\n# Each entry should have a positive/ALLOW entry created as well, with further documentation.\n# Exceptions:\n# - Claude-User: No published IP allowlist\n- name: \"ai-clients\"\n user_agent_regex: >-\n ChatGPT-User|Claude-User|MistralAI-User|Perplexity-User\n action: DENY\n"
},
{
"path": "data/clients/docker-client.yaml",
"content": "- name: allow-docker-client\n action: ALLOW\n expression:\n all:\n - path.startsWith(\"/v2/\")\n - userAgent.contains(\"docker/\")\n - userAgent.contains(\"git-commit/\")\n - '\"Accept\" in headers'\n - headers[\"Accept\"].contains(\"vnd.docker.distribution\")\n - '\"Baggage\" in headers'\n - headers[\"Baggage\"].contains(\"trigger\")\n\n- name: allow-crane-client\n action: ALLOW\n expression:\n all:\n - userAgent.contains(\"crane/\")\n - userAgent.contains(\"go-containerregistry/\")\n\n- name: allow-docker-distribution-api-client\n action: ALLOW\n expression:\n all:\n - '\"Docker-Distribution-Api-Version\" in headers'\n - '!(userAgent.contains(\"Mozilla\"))'\n\n- name: allow-go-containerregistry-client\n action: ALLOW\n expression:\n all:\n - path.startsWith(\"/v2/\")\n - userAgent.contains(\"go-containerregistry/\")\n\n- name: allow-buildah\n action: ALLOW\n expression:\n all:\n - path.startsWith(\"/v2/\")\n - userAgent.contains(\"Buildah/\")\n\n- name: allow-podman\n action: ALLOW\n expression:\n all:\n - path.startsWith(\"/v2/\")\n - userAgent.contains(\"containers/\")\n\n- name: allow-containerd\n action: ALLOW\n expression:\n all:\n - path.startsWith(\"/v2/\")\n - userAgent.contains(\"containerd/\")\n\n- name: allow-renovate\n action: ALLOW\n expression:\n all:\n - path.startsWith(\"/v2/\")\n - userAgent.contains(\"Renovate/\")\n"
},
{
"path": "data/clients/git.yaml",
"content": "- name: allow-git-clients\n action: ALLOW\n expression:\n all:\n - >\n ( \n userAgent.startsWith(\"git/\") ||\n userAgent.contains(\"libgit\") ||\n userAgent.startsWith(\"go-git\") ||\n userAgent.startsWith(\"JGit/\") ||\n userAgent.startsWith(\"JGit-\")\n )\n - '\"Accept\" in headers'\n - headers[\"Accept\"] == \"*/*\"\n - '\"Cache-Control\" in headers'\n - headers[\"Cache-Control\"] == \"no-cache\"\n - '\"Pragma\" in headers'\n - headers[\"Pragma\"] == \"no-cache\"\n - '\"Accept-Encoding\" in headers'\n - headers[\"Accept-Encoding\"].contains(\"gzip\")\n"
},
{
"path": "data/clients/go-get.yaml",
"content": "- name: go-get\n action: ALLOW\n expression:\n all:\n - userAgent.startsWith(\"Go-http-client/\")\n - '\"go-get\" in query'\n - query[\"go-get\"] == \"1\"\n"
},
{
"path": "data/clients/mistral-mistralai-user.yaml",
"content": "# Acts on behalf of user requests\n# https://docs.mistral.ai/robots/\n- name: mistral-mistralai-user\n user_agent_regex: MistralAI-User/.+; \\+https\\://docs\\.mistral\\.ai/robots\n action: ALLOW\n # https://mistral.ai/mistralai-user-ips.json\n remote_addresses: [\"20.240.160.161/32\", \"20.240.160.1/32\"]\n"
},
{
"path": "data/clients/openai-chatgpt-user.yaml",
"content": "# Acts on behalf of user requests\n# https://platform.openai.com/docs/bots/overview-of-openai-crawlers\n- name: openai-chatgpt-user\n user_agent_regex: ChatGPT-User/.+; \\+https\\://openai\\.com/bot\n action: ALLOW\n # https://openai.com/chatgpt-user.json\n # curl 'https://openai.com/chatgpt-user.json' | jq '.prefixes.[].ipv4Prefix' | sed 's/$/,/'\n remote_addresses:\n [\n \"13.65.138.112/28\",\n \"23.98.179.16/28\",\n \"13.65.138.96/28\",\n \"172.183.222.128/28\",\n \"20.102.212.144/28\",\n \"40.116.73.208/28\",\n \"172.183.143.224/28\",\n \"52.190.190.16/28\",\n \"13.83.237.176/28\",\n \"51.8.155.64/28\",\n \"74.249.86.176/28\",\n \"51.8.155.48/28\",\n \"20.55.229.144/28\",\n \"135.237.131.208/28\",\n \"135.237.133.48/28\",\n \"51.8.155.112/28\",\n \"135.237.133.112/28\",\n \"52.159.249.96/28\",\n \"52.190.137.16/28\",\n \"52.255.111.112/28\",\n \"40.84.181.32/28\",\n \"172.178.141.112/28\",\n \"52.190.142.64/28\",\n \"172.178.140.144/28\",\n \"52.190.137.144/28\",\n \"172.178.141.128/28\",\n \"57.154.187.32/28\",\n \"4.196.118.112/28\",\n \"20.193.50.32/28\",\n \"20.215.188.192/28\",\n \"20.215.214.16/28\",\n \"4.197.22.112/28\",\n \"4.197.115.112/28\",\n \"172.213.21.16/28\",\n \"172.213.11.144/28\",\n \"172.213.12.112/28\",\n \"172.213.21.144/28\",\n \"20.90.7.144/28\",\n \"57.154.175.0/28\",\n \"57.154.174.112/28\",\n \"52.236.94.144/28\",\n \"137.135.191.176/28\",\n \"23.98.186.192/28\",\n \"23.98.186.96/28\",\n \"23.98.186.176/28\",\n \"23.98.186.64/28\",\n \"68.221.67.192/28\",\n \"68.221.67.160/28\",\n \"13.83.167.128/28\",\n \"20.228.106.176/28\",\n \"52.159.227.32/28\",\n \"68.220.57.64/28\",\n \"172.213.21.112/28\",\n \"68.221.67.224/28\",\n \"68.221.75.16/28\",\n \"20.97.189.96/28\",\n \"52.252.113.240/28\",\n \"52.230.163.32/28\",\n \"172.212.159.64/28\",\n \"52.255.111.80/28\",\n \"52.255.111.0/28\",\n \"4.151.241.240/28\",\n \"52.255.111.32/28\",\n \"52.255.111.48/28\",\n \"52.255.111.16/28\",\n \"52.230.164.176/28\",\n \"52.176.139.176/28\",\n \"52.173.234.16/28\",\n \"4.151.71.176/28\",\n \"4.151.119.48/28\",\n \"52.255.109.112/28\",\n \"52.255.109.80/28\",\n \"20.161.75.208/28\",\n \"68.154.28.96/28\",\n \"52.255.109.128/28\",\n \"52.225.75.208/28\",\n \"52.190.139.48/28\",\n \"68.221.67.240/28\",\n \"52.156.77.144/28\",\n \"52.148.129.32/28\",\n \"40.84.221.208/28\",\n \"104.210.139.224/28\",\n \"40.84.221.224/28\",\n \"104.210.139.192/28\",\n ]\n"
},
{
"path": "data/clients/perplexity-user.yaml",
"content": "# Acts on behalf of user requests\n# https://docs.perplexity.ai/guides/bots\n- name: perplexity-user\n user_agent_regex: Perplexity-User/.+; \\+https\\://perplexity\\.ai/perplexity-user\n action: ALLOW\n # https://www.perplexity.com/perplexity-user.json\n remote_addresses:\n [\"44.208.221.197/32\", \"34.193.163.52/32\", \"18.97.21.0/30\", \"18.97.43.80/29\"]\n"
},
{
"path": "data/clients/small-internet-browsers/_permissive.yaml",
"content": "- import: (data)/clients/small-internet-browsers/netsurf.yaml\n- import: (data)/clients/small-internet-browsers/palemoon.yaml\n"
},
{
"path": "data/clients/small-internet-browsers/netsurf.yaml",
"content": "- name: \"reduce-weight-netsurf\"\n user_agent_regex: \"NetSurf\"\n action: WEIGH\n weight:\n adjust: -5\n"
},
{
"path": "data/clients/small-internet-browsers/palemoon.yaml",
"content": "- name: \"reduce-weight-palemoon\"\n user_agent_regex: \"PaleMoon\"\n action: WEIGH\n weight:\n adjust: -5\n"
},
{
"path": "data/clients/telegram-preview.yaml",
"content": "- name: telegrambot\n action: ALLOW\n expression:\n all:\n - userAgent.matches(\"TelegramBot\")\n - verifyFCrDNS(remoteAddress, \"ptr\\\\.telegram\\\\.org$\")\n"
},
{
"path": "data/clients/vk-preview.yaml",
"content": "- name: vkbot\n action: ALLOW\n expression:\n all:\n - userAgent.matches(\"vkShare[^+]+\\\\+http\\\\://vk\\\\.com/dev/Share\")\n - verifyFCrDNS(remoteAddress, \"^snipster\\\\d+\\\\.go\\\\.mail\\\\.ru$\")\n"
},
{
"path": "data/clients/x-firefox-ai.yaml",
"content": "# https://connect.mozilla.org/t5/firefox-labs/try-out-link-previews-in-firefox-labs-138-and-share-your/td-p/92012\n- name: x-firefox-ai\n action: WEIGH\n expression: '\"X-Firefox-Ai\" in headers'\n weight:\n adjust: 5\n"
},
{
"path": "data/common/acts-like-browser.yaml",
"content": "# Assert behaviour that only genuine browsers display. This ensures that modern Chrome\n# or Firefox versions will get through without a challenge.\n#\n# These rules have been known to be bypassed by some of the worst automated scrapers.\n# Use at your own risk.\n\n- name: realistic-browser-catchall\n expression:\n all:\n - '\"User-Agent\" in headers'\n - '( userAgent.contains(\"Firefox\") ) || ( userAgent.contains(\"Chrome\") ) || ( userAgent.contains(\"Safari\") )'\n - '\"Accept\" in headers'\n - '\"Sec-Fetch-Dest\" in headers'\n - '\"Sec-Fetch-Mode\" in headers'\n - '\"Sec-Fetch-Site\" in headers'\n - '\"Accept-Encoding\" in headers'\n - '( headers[\"Accept-Encoding\"].contains(\"zstd\") || headers[\"Accept-Encoding\"].contains(\"br\") )'\n - '\"Accept-Language\" in headers'\n action: WEIGH\n weight:\n adjust: -10\n\n# The Upgrade-Insecure-Requests header is typically sent by browsers, but not always\n- name: upgrade-insecure-requests\n expression: '\"Upgrade-Insecure-Requests\" in headers'\n action: WEIGH\n weight:\n adjust: -2\n\n# Chrome should behave like Chrome\n- name: chrome-is-proper\n expression:\n all:\n - userAgent.contains(\"Chrome\")\n - '\"Sec-Ch-Ua\" in headers'\n - 'headers[\"Sec-Ch-Ua\"].contains(\"Chromium\")'\n - '\"Sec-Ch-Ua-Mobile\" in headers'\n - '\"Sec-Ch-Ua-Platform\" in headers'\n action: WEIGH\n weight:\n adjust: -5\n\n- name: should-have-accept\n expression: '!(\"Accept\" in headers)'\n action: WEIGH\n weight:\n adjust: 5\n\n# Generic catchall rule\n- name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: WEIGH\n weight:\n adjust: 10\n"
},
{
"path": "data/common/allow-api-like.yaml",
"content": "- name: allow-api-routes\n action: ALLOW\n expression:\n all:\n - '!(method == \"HEAD\" || method == \"GET\")'\n - path.startsWith(\"/api/\")\n"
},
{
"path": "data/common/allow-private-addresses.yaml",
"content": "- name: ipv4-rfc-1918\n action: ALLOW\n remote_addresses:\n - 10.0.0.0/8\n - 172.16.0.0/12\n - 192.168.0.0/16\n - 100.64.0.0/10\n- name: ipv6-ula\n action: ALLOW\n remote_addresses:\n - fc00::/7\n- name: ipv6-link-local\n action: ALLOW\n remote_addresses:\n - fe80::/10\n"
},
{
"path": "data/common/json-api.yaml",
"content": "- name: allow-api-requests\n action: ALLOW\n expression:\n all:\n - '\"Accept\" in headers'\n - 'headers[\"Accept\"] == \"application/json\"'\n - 'path.startsWith(\"/api/\")'\n"
},
{
"path": "data/common/keep-internet-working.yaml",
"content": "# Common \"keeping the internet working\" routes\n- name: well-known\n path_regex: ^/\\.well-known/.*$\n action: ALLOW\n- name: favicon\n path_regex: ^/favicon\\.(?:ico|png|gif|jpg|jpeg|svg)$\n action: ALLOW\n- name: robots-txt\n path_regex: ^/robots\\.txt$\n action: ALLOW\n- name: sitemap\n path_regex: ^/sitemap\\.xml$\n action: ALLOW\n"
},
{
"path": "data/common/rfc-violations.yaml",
"content": "- name: no-user-agent-string\n action: DENY\n expression: userAgent == \"\"\n"
},
{
"path": "data/crawlers/_allow-good.yaml",
"content": "- import: (data)/crawlers/googlebot.yaml\n- import: (data)/crawlers/applebot.yaml\n- import: (data)/crawlers/bingbot.yaml\n- import: (data)/crawlers/duckduckbot.yaml\n- import: (data)/crawlers/qwantbot.yaml\n- import: (data)/crawlers/internet-archive.yaml\n- import: (data)/crawlers/kagibot.yaml\n- import: (data)/crawlers/marginalia.yaml\n- import: (data)/crawlers/mojeekbot.yaml\n- import: (data)/crawlers/commoncrawl.yaml\n- import: (data)/crawlers/wikimedia-citoid.yaml\n- import: (data)/crawlers/yandexbot.yaml\n"
},
{
"path": "data/crawlers/ai-search.yaml",
"content": "# User agents that index exclusively for search in for AI systems.\n# Each entry should have a positive/ALLOW entry created as well, with further documentation.\n# Exceptions:\n# - Claude-SearchBot: No published IP allowlist\n- name: \"ai-crawlers-search\"\n user_agent_regex: >-\n OAI-SearchBot|Claude-SearchBot|PerplexityBot\n action: DENY\n"
},
{
"path": "data/crawlers/ai-training.yaml",
"content": "# User agents that crawl for training AI/LLM systems\n# Each entry should have a positive/ALLOW entry created as well, with further documentation.\n# Exceptions:\n# - ClaudeBot: No published IP allowlist\n- name: \"ai-crawlers-training\"\n user_agent_regex: >-\n GPTBot|ClaudeBot\n action: DENY\n"
},
{
"path": "data/crawlers/alibaba-cloud.yaml",
"content": "- name: alibaba-cloud\n action: DENY\n # Updated 2025-08-20 from IP addresses for AS45102\n remote_addresses:\n - 103.81.186.0/23\n - 110.76.21.0/24\n - 110.76.23.0/24\n - 116.251.64.0/18\n - 139.95.0.0/23\n - 139.95.10.0/23\n - 139.95.12.0/23\n - 139.95.14.0/23\n - 139.95.16.0/23\n - 139.95.18.0/23\n - 139.95.2.0/23\n - 139.95.4.0/23\n - 139.95.6.0/23\n - 139.95.64.0/24\n - 139.95.8.0/23\n - 14.1.112.0/22\n - 14.1.115.0/24\n - 140.205.1.0/24\n - 140.205.122.0/24\n - 147.139.0.0/17\n - 147.139.0.0/18\n - 147.139.128.0/17\n - 147.139.128.0/18\n - 147.139.155.0/24\n - 147.139.192.0/18\n - 147.139.64.0/18\n - 149.129.0.0/20\n - 149.129.0.0/21\n - 149.129.16.0/23\n - 149.129.192.0/18\n - 149.129.192.0/19\n - 149.129.224.0/19\n - 149.129.32.0/19\n - 149.129.64.0/18\n - 149.129.64.0/19\n - 149.129.8.0/21\n - 149.129.96.0/19\n - 156.227.20.0/24\n - 156.236.12.0/24\n - 156.236.17.0/24\n - 156.240.76.0/23\n - 156.245.1.0/24\n - 161.117.0.0/16\n - 161.117.0.0/17\n - 161.117.126.0/24\n - 161.117.127.0/24\n - 161.117.128.0/17\n - 161.117.128.0/24\n - 161.117.129.0/24\n - 161.117.138.0/24\n - 161.117.143.0/24\n - 170.33.104.0/24\n - 170.33.105.0/24\n - 170.33.106.0/24\n - 170.33.107.0/24\n - 170.33.136.0/24\n - 170.33.137.0/24\n - 170.33.138.0/24\n - 170.33.20.0/24\n - 170.33.21.0/24\n - 170.33.22.0/24\n - 170.33.23.0/24\n - 170.33.24.0/24\n - 170.33.29.0/24\n - 170.33.30.0/24\n - 170.33.31.0/24\n - 170.33.32.0/24\n - 170.33.33.0/24\n - 170.33.34.0/24\n - 170.33.35.0/24\n - 170.33.64.0/24\n - 170.33.65.0/24\n - 170.33.66.0/24\n - 170.33.68.0/24\n - 170.33.69.0/24\n - 170.33.72.0/24\n - 170.33.73.0/24\n - 170.33.76.0/24\n - 170.33.77.0/24\n - 170.33.78.0/24\n - 170.33.79.0/24\n - 170.33.80.0/24\n - 170.33.81.0/24\n - 170.33.82.0/24\n - 170.33.83.0/24\n - 170.33.84.0/24\n - 170.33.85.0/24\n - 170.33.86.0/24\n - 170.33.88.0/24\n - 170.33.90.0/24\n - 170.33.92.0/24\n - 170.33.93.0/24\n - 185.78.106.0/23\n - 198.11.128.0/18\n - 198.11.137.0/24\n - 198.11.184.0/21\n - 202.144.199.0/24\n - 203.107.64.0/24\n - 203.107.65.0/24\n - 203.107.66.0/24\n - 203.107.67.0/24\n - 203.107.68.0/24\n - 205.204.102.0/23\n - 205.204.111.0/24\n - 205.204.117.0/24\n - 205.204.125.0/24\n - 205.204.96.0/19\n - 223.5.5.0/24\n - 223.6.6.0/24\n - 2400:3200::/48\n - 2400:3200:baba::/48\n - 2400:b200:4100::/48\n - 2400:b200:4101::/48\n - 2400:b200:4102::/48\n - 2400:b200:4103::/48\n - 2401:8680:4100::/48\n - 2401:b180:4100::/48\n - 2404:2280:1000::/36\n - 2404:2280:1000::/37\n - 2404:2280:1800::/37\n - 2404:2280:2000::/36\n - 2404:2280:2000::/37\n - 2404:2280:2800::/37\n - 2404:2280:3000::/36\n - 2404:2280:3000::/37\n - 2404:2280:3800::/37\n - 2404:2280:4000::/36\n - 2404:2280:4000::/37\n - 2404:2280:4800::/37\n - 2408:4000:1000::/48\n - 2408:4009:500::/48\n - 240b:4000::/32\n - 240b:4000::/33\n - 240b:4000:8000::/33\n - 240b:4000:fffe::/48\n - 240b:4001::/32\n - 240b:4001::/33\n - 240b:4001:8000::/33\n - 240b:4002::/32\n - 240b:4002::/33\n - 240b:4002:8000::/33\n - 240b:4004::/32\n - 240b:4004::/33\n - 240b:4004:8000::/33\n - 240b:4005::/32\n - 240b:4005::/33\n - 240b:4005:8000::/33\n - 240b:4006::/48\n - 240b:4006:1000::/44\n - 240b:4006:1000::/45\n - 240b:4006:1000::/47\n - 240b:4006:1002::/47\n - 240b:4006:1008::/45\n - 240b:4006:1010::/44\n - 240b:4006:1010::/45\n - 240b:4006:1018::/45\n - 240b:4006:1020::/44\n - 240b:4006:1020::/45\n - 240b:4006:1028::/45\n - 240b:4007::/32\n - 240b:4007::/33\n - 240b:4007:8000::/33\n - 240b:4009::/32\n - 240b:4009::/33\n - 240b:4009:8000::/33\n - 240b:400b::/32\n - 240b:400b::/33\n - 240b:400b:8000::/33\n - 240b:400c::/32\n - 240b:400c::/33\n - 240b:400c::/40\n - 240b:400c::/41\n - 240b:400c:100::/40\n - 240b:400c:100::/41\n - 240b:400c:180::/41\n - 240b:400c:80::/41\n - 240b:400c:8000::/33\n - 240b:400c:f00::/48\n - 240b:400c:f01::/48\n - 240b:400c:ffff::/48\n - 240b:400d::/32\n - 240b:400d::/33\n - 240b:400d:8000::/33\n - 240b:400e::/32\n - 240b:400e::/33\n - 240b:400e:8000::/33\n - 240b:400f::/32\n - 240b:400f::/33\n - 240b:400f:8000::/33\n - 240b:4011::/32\n - 240b:4011::/33\n - 240b:4011:8000::/33\n - 240b:4012::/48\n - 240b:4013::/32\n - 240b:4013::/33\n - 240b:4013:8000::/33\n - 240b:4014::/32\n - 240b:4014::/33\n - 240b:4014:8000::/33\n - 43.100.0.0/15\n - 43.100.0.0/16\n - 43.101.0.0/16\n - 43.102.0.0/20\n - 43.102.112.0/20\n - 43.102.16.0/20\n - 43.102.32.0/20\n - 43.102.48.0/20\n - 43.102.64.0/20\n - 43.102.80.0/20\n - 43.102.96.0/20\n - 43.103.0.0/17\n - 43.103.0.0/18\n - 43.103.64.0/18\n - 43.104.0.0/15\n - 43.104.0.0/16\n - 43.105.0.0/16\n - 43.108.0.0/17\n - 43.108.0.0/18\n - 43.108.64.0/18\n - 43.91.0.0/16\n - 43.91.0.0/17\n - 43.91.128.0/17\n - 43.96.10.0/24\n - 43.96.100.0/24\n - 43.96.101.0/24\n - 43.96.102.0/24\n - 43.96.104.0/24\n - 43.96.11.0/24\n - 43.96.20.0/24\n - 43.96.21.0/24\n - 43.96.23.0/24\n - 43.96.24.0/24\n - 43.96.25.0/24\n - 43.96.3.0/24\n - 43.96.32.0/24\n - 43.96.33.0/24\n - 43.96.34.0/24\n - 43.96.35.0/24\n - 43.96.4.0/24\n - 43.96.40.0/24\n - 43.96.5.0/24\n - 43.96.52.0/24\n - 43.96.6.0/24\n - 43.96.66.0/24\n - 43.96.67.0/24\n - 43.96.68.0/24\n - 43.96.69.0/24\n - 43.96.7.0/24\n - 43.96.70.0/24\n - 43.96.71.0/24\n - 43.96.72.0/24\n - 43.96.73.0/24\n - 43.96.74.0/24\n - 43.96.75.0/24\n - 43.96.8.0/24\n - 43.96.80.0/24\n - 43.96.81.0/24\n - 43.96.84.0/24\n - 43.96.85.0/24\n - 43.96.86.0/24\n - 43.96.88.0/24\n - 43.96.9.0/24\n - 43.96.96.0/24\n - 43.98.0.0/16\n - 43.98.0.0/17\n - 43.98.128.0/17\n - 43.99.0.0/16\n - 43.99.0.0/17\n - 43.99.128.0/17\n - 45.199.179.0/24\n - 47.235.0.0/22\n - 47.235.0.0/23\n - 47.235.1.0/24\n - 47.235.10.0/23\n - 47.235.10.0/24\n - 47.235.11.0/24\n - 47.235.12.0/23\n - 47.235.12.0/24\n - 47.235.13.0/24\n - 47.235.16.0/23\n - 47.235.16.0/24\n - 47.235.18.0/23\n - 47.235.18.0/24\n - 47.235.19.0/24\n - 47.235.2.0/23\n - 47.235.20.0/24\n - 47.235.21.0/24\n - 47.235.22.0/24\n - 47.235.23.0/24\n - 47.235.24.0/22\n - 47.235.24.0/23\n - 47.235.26.0/23\n - 47.235.28.0/23\n - 47.235.28.0/24\n - 47.235.29.0/24\n - 47.235.30.0/24\n - 47.235.31.0/24\n - 47.235.4.0/24\n - 47.235.5.0/24\n - 47.235.6.0/23\n - 47.235.6.0/24\n - 47.235.7.0/24\n - 47.235.8.0/24\n - 47.235.9.0/24\n - 47.236.0.0/15\n - 47.236.0.0/16\n - 47.237.0.0/16\n - 47.237.32.0/20\n - 47.237.34.0/24\n - 47.238.0.0/15\n - 47.238.0.0/16\n - 47.239.0.0/16\n - 47.240.0.0/16\n - 47.240.0.0/17\n - 47.240.128.0/17\n - 47.241.0.0/16\n - 47.241.0.0/17\n - 47.241.128.0/17\n - 47.242.0.0/15\n - 47.242.0.0/16\n - 47.243.0.0/16\n - 47.244.0.0/16\n - 47.244.0.0/17\n - 47.244.128.0/17\n - 47.244.73.0/24\n - 47.245.0.0/18\n - 47.245.0.0/19\n - 47.245.128.0/17\n - 47.245.128.0/18\n - 47.245.192.0/18\n - 47.245.32.0/19\n - 47.245.64.0/18\n - 47.245.64.0/19\n - 47.245.96.0/19\n - 47.246.100.0/22\n - 47.246.104.0/21\n - 47.246.104.0/22\n - 47.246.108.0/22\n - 47.246.120.0/24\n - 47.246.122.0/24\n - 47.246.123.0/24\n - 47.246.124.0/24\n - 47.246.125.0/24\n - 47.246.128.0/22\n - 47.246.128.0/23\n - 47.246.130.0/23\n - 47.246.132.0/22\n - 47.246.132.0/23\n - 47.246.134.0/23\n - 47.246.136.0/21\n - 47.246.136.0/22\n - 47.246.140.0/22\n - 47.246.144.0/23\n - 47.246.144.0/24\n - 47.246.145.0/24\n - 47.246.146.0/23\n - 47.246.146.0/24\n - 47.246.147.0/24\n - 47.246.150.0/23\n - 47.246.150.0/24\n - 47.246.151.0/24\n - 47.246.152.0/23\n - 47.246.152.0/24\n - 47.246.153.0/24\n - 47.246.154.0/24\n - 47.246.155.0/24\n - 47.246.156.0/22\n - 47.246.156.0/23\n - 47.246.158.0/23\n - 47.246.160.0/20\n - 47.246.160.0/21\n - 47.246.168.0/21\n - 47.246.176.0/20\n - 47.246.176.0/21\n - 47.246.184.0/21\n - 47.246.192.0/22\n - 47.246.192.0/23\n - 47.246.194.0/23\n - 47.246.196.0/22\n - 47.246.196.0/23\n - 47.246.198.0/23\n - 47.246.32.0/22\n - 47.246.66.0/24\n - 47.246.67.0/24\n - 47.246.68.0/23\n - 47.246.68.0/24\n - 47.246.69.0/24\n - 47.246.72.0/21\n - 47.246.72.0/22\n - 47.246.76.0/22\n - 47.246.80.0/24\n - 47.246.82.0/23\n - 47.246.82.0/24\n - 47.246.83.0/24\n - 47.246.84.0/22\n - 47.246.84.0/23\n - 47.246.86.0/23\n - 47.246.88.0/22\n - 47.246.88.0/23\n - 47.246.90.0/23\n - 47.246.92.0/23\n - 47.246.92.0/24\n - 47.246.93.0/24\n - 47.246.96.0/21\n - 47.246.96.0/22\n - 47.250.0.0/17\n - 47.250.0.0/18\n - 47.250.128.0/17\n - 47.250.128.0/18\n - 47.250.192.0/18\n - 47.250.64.0/18\n - 47.250.99.0/24\n - 47.251.0.0/16\n - 47.251.0.0/17\n - 47.251.128.0/17\n - 47.251.224.0/22\n - 47.252.0.0/17\n - 47.252.0.0/18\n - 47.252.128.0/17\n - 47.252.128.0/18\n - 47.252.192.0/18\n - 47.252.64.0/18\n - 47.252.67.0/24\n - 47.253.0.0/16\n - 47.253.0.0/17\n - 47.253.128.0/17\n - 47.254.0.0/17\n - 47.254.0.0/18\n - 47.254.113.0/24\n - 47.254.128.0/18\n - 47.254.128.0/19\n - 47.254.160.0/19\n - 47.254.192.0/18\n - 47.254.192.0/19\n - 47.254.224.0/19\n - 47.254.64.0/18\n - 47.52.0.0/16\n - 47.52.0.0/17\n - 47.52.128.0/17\n - 47.56.0.0/15\n - 47.56.0.0/16\n - 47.57.0.0/16\n - 47.74.0.0/18\n - 47.74.0.0/19\n - 47.74.0.0/21\n - 47.74.128.0/17\n - 47.74.128.0/18\n - 47.74.192.0/18\n - 47.74.32.0/19\n - 47.74.64.0/18\n - 47.74.64.0/19\n - 47.74.96.0/19\n - 47.75.0.0/16\n - 47.75.0.0/17\n - 47.75.128.0/17\n - 47.76.0.0/16\n - 47.76.0.0/17\n - 47.76.128.0/17\n - 47.77.0.0/22\n - 47.77.0.0/23\n - 47.77.104.0/21\n - 47.77.12.0/22\n - 47.77.128.0/17\n - 47.77.128.0/18\n - 47.77.128.0/21\n - 47.77.136.0/21\n - 47.77.144.0/21\n - 47.77.152.0/21\n - 47.77.16.0/21\n - 47.77.16.0/22\n - 47.77.192.0/18\n - 47.77.2.0/23\n - 47.77.20.0/22\n - 47.77.24.0/22\n - 47.77.24.0/23\n - 47.77.26.0/23\n - 47.77.32.0/19\n - 47.77.32.0/20\n - 47.77.4.0/22\n - 47.77.4.0/23\n - 47.77.48.0/20\n - 47.77.6.0/23\n - 47.77.64.0/19\n - 47.77.64.0/20\n - 47.77.8.0/21\n - 47.77.8.0/22\n - 47.77.80.0/20\n - 47.77.96.0/20\n - 47.77.96.0/21\n - 47.78.0.0/17\n - 47.78.128.0/17\n - 47.79.0.0/20\n - 47.79.0.0/21\n - 47.79.104.0/21\n - 47.79.112.0/20\n - 47.79.128.0/19\n - 47.79.128.0/20\n - 47.79.144.0/20\n - 47.79.16.0/20\n - 47.79.16.0/21\n - 47.79.192.0/18\n - 47.79.192.0/19\n - 47.79.224.0/19\n - 47.79.24.0/21\n - 47.79.32.0/20\n - 47.79.32.0/21\n - 47.79.40.0/21\n - 47.79.48.0/20\n - 47.79.48.0/21\n - 47.79.52.0/23\n - 47.79.54.0/23\n - 47.79.56.0/21\n - 47.79.56.0/23\n - 47.79.58.0/23\n - 47.79.60.0/23\n - 47.79.62.0/23\n - 47.79.64.0/20\n - 47.79.64.0/21\n - 47.79.72.0/21\n - 47.79.8.0/21\n - 47.79.80.0/20\n - 47.79.80.0/21\n - 47.79.83.0/24\n - 47.79.88.0/21\n - 47.79.96.0/19\n - 47.79.96.0/20\n - 47.80.0.0/18\n - 47.80.0.0/19\n - 47.80.128.0/17\n - 47.80.128.0/18\n - 47.80.192.0/18\n - 47.80.32.0/19\n - 47.80.64.0/18\n - 47.80.64.0/19\n - 47.80.96.0/19\n - 47.81.0.0/18\n - 47.81.0.0/19\n - 47.81.128.0/17\n - 47.81.128.0/18\n - 47.81.192.0/18\n - 47.81.32.0/19\n - 47.81.64.0/18\n - 47.81.64.0/19\n - 47.81.96.0/19\n - 47.82.0.0/18\n - 47.82.0.0/19\n - 47.82.10.0/23\n - 47.82.12.0/23\n - 47.82.128.0/17\n - 47.82.128.0/18\n - 47.82.14.0/23\n - 47.82.192.0/18\n - 47.82.32.0/19\n - 47.82.32.0/21\n - 47.82.40.0/21\n - 47.82.48.0/21\n - 47.82.56.0/21\n - 47.82.64.0/18\n - 47.82.64.0/19\n - 47.82.8.0/23\n - 47.82.96.0/19\n - 47.83.0.0/16\n - 47.83.0.0/17\n - 47.83.128.0/17\n - 47.83.32.0/21\n - 47.83.40.0/21\n - 47.83.48.0/21\n - 47.83.56.0/21\n - 47.84.0.0/16\n - 47.84.0.0/17\n - 47.84.128.0/17\n - 47.84.144.0/21\n - 47.84.152.0/21\n - 47.84.160.0/21\n - 47.84.168.0/21\n - 47.85.0.0/16\n - 47.85.0.0/17\n - 47.85.112.0/22\n - 47.85.112.0/23\n - 47.85.114.0/23\n - 47.85.128.0/17\n - 47.86.0.0/16\n - 47.86.0.0/17\n - 47.86.128.0/17\n - 47.87.0.0/18\n - 47.87.0.0/19\n - 47.87.128.0/18\n - 47.87.128.0/19\n - 47.87.160.0/19\n - 47.87.192.0/22\n - 47.87.192.0/23\n - 47.87.194.0/23\n - 47.87.196.0/22\n - 47.87.196.0/23\n - 47.87.198.0/23\n - 47.87.200.0/22\n - 47.87.200.0/23\n - 47.87.202.0/23\n - 47.87.204.0/22\n - 47.87.204.0/23\n - 47.87.206.0/23\n - 47.87.208.0/22\n - 47.87.208.0/23\n - 47.87.210.0/23\n - 47.87.212.0/22\n - 47.87.212.0/23\n - 47.87.214.0/23\n - 47.87.216.0/22\n - 47.87.216.0/23\n - 47.87.218.0/23\n - 47.87.220.0/22\n - 47.87.220.0/23\n - 47.87.222.0/23\n - 47.87.224.0/22\n - 47.87.224.0/23\n - 47.87.226.0/23\n - 47.87.228.0/22\n - 47.87.228.0/23\n - 47.87.230.0/23\n - 47.87.232.0/22\n - 47.87.232.0/23\n - 47.87.234.0/23\n - 47.87.236.0/22\n - 47.87.236.0/23\n - 47.87.238.0/23\n - 47.87.240.0/22\n - 47.87.240.0/23\n - 47.87.242.0/23\n - 47.87.32.0/19\n - 47.87.64.0/18\n - 47.87.64.0/19\n - 47.87.96.0/19\n - 47.88.0.0/17\n - 47.88.0.0/18\n - 47.88.109.0/24\n - 47.88.128.0/17\n - 47.88.128.0/18\n - 47.88.135.0/24\n - 47.88.192.0/18\n - 47.88.41.0/24\n - 47.88.42.0/24\n - 47.88.43.0/24\n - 47.88.64.0/18\n - 47.89.0.0/18\n - 47.89.0.0/19\n - 47.89.100.0/24\n - 47.89.101.0/24\n - 47.89.102.0/24\n - 47.89.103.0/24\n - 47.89.104.0/21\n - 47.89.104.0/22\n - 47.89.108.0/22\n - 47.89.122.0/24\n - 47.89.123.0/24\n - 47.89.124.0/23\n - 47.89.124.0/24\n - 47.89.125.0/24\n - 47.89.128.0/18\n - 47.89.128.0/19\n - 47.89.160.0/19\n - 47.89.192.0/18\n - 47.89.192.0/19\n - 47.89.221.0/24\n - 47.89.224.0/19\n - 47.89.32.0/19\n - 47.89.72.0/22\n - 47.89.72.0/23\n - 47.89.74.0/23\n - 47.89.76.0/22\n - 47.89.76.0/23\n - 47.89.78.0/23\n - 47.89.80.0/23\n - 47.89.82.0/23\n - 47.89.84.0/24\n - 47.89.88.0/22\n - 47.89.88.0/23\n - 47.89.90.0/23\n - 47.89.92.0/22\n - 47.89.92.0/23\n - 47.89.94.0/23\n - 47.89.96.0/24\n - 47.89.97.0/24\n - 47.89.98.0/23\n - 47.89.99.0/24\n - 47.90.0.0/17\n - 47.90.0.0/18\n - 47.90.128.0/17\n - 47.90.128.0/18\n - 47.90.172.0/24\n - 47.90.173.0/24\n - 47.90.174.0/24\n - 47.90.175.0/24\n - 47.90.192.0/18\n - 47.90.64.0/18\n - 47.91.0.0/19\n - 47.91.0.0/20\n - 47.91.112.0/20\n - 47.91.128.0/17\n - 47.91.128.0/18\n - 47.91.16.0/20\n - 47.91.192.0/18\n - 47.91.32.0/19\n - 47.91.32.0/20\n - 47.91.48.0/20\n - 47.91.64.0/19\n - 47.91.64.0/20\n - 47.91.80.0/20\n - 47.91.96.0/19\n - 47.91.96.0/20\n - 5.181.224.0/23\n - 59.82.136.0/23\n - 8.208.0.0/16\n - 8.208.0.0/17\n - 8.208.0.0/18\n - 8.208.0.0/19\n - 8.208.128.0/17\n - 8.208.141.0/24\n - 8.208.32.0/19\n - 8.209.0.0/19\n - 8.209.0.0/20\n - 8.209.128.0/18\n - 8.209.128.0/19\n - 8.209.16.0/20\n - 8.209.160.0/19\n - 8.209.192.0/18\n - 8.209.192.0/19\n - 8.209.224.0/19\n - 8.209.36.0/23\n - 8.209.36.0/24\n - 8.209.37.0/24\n - 8.209.38.0/23\n - 8.209.38.0/24\n - 8.209.39.0/24\n - 8.209.40.0/22\n - 8.209.40.0/23\n - 8.209.42.0/23\n - 8.209.44.0/22\n - 8.209.44.0/23\n - 8.209.46.0/23\n - 8.209.48.0/20\n - 8.209.48.0/21\n - 8.209.56.0/21\n - 8.209.64.0/18\n - 8.209.64.0/19\n - 8.209.96.0/19\n - 8.210.0.0/16\n - 8.210.0.0/17\n - 8.210.128.0/17\n - 8.210.240.0/24\n - 8.211.0.0/17\n - 8.211.0.0/18\n - 8.211.104.0/21\n - 8.211.128.0/18\n - 8.211.128.0/19\n - 8.211.160.0/19\n - 8.211.192.0/18\n - 8.211.192.0/19\n - 8.211.224.0/19\n - 8.211.226.0/24\n - 8.211.64.0/18\n - 8.211.80.0/21\n - 8.211.88.0/21\n - 8.211.96.0/21\n - 8.212.0.0/17\n - 8.212.0.0/18\n - 8.212.128.0/18\n - 8.212.128.0/19\n - 8.212.160.0/19\n - 8.212.192.0/18\n - 8.212.192.0/19\n - 8.212.224.0/19\n - 8.212.64.0/18\n - 8.213.0.0/17\n - 8.213.0.0/18\n - 8.213.128.0/19\n - 8.213.128.0/20\n - 8.213.144.0/20\n - 8.213.160.0/21\n - 8.213.160.0/22\n - 8.213.164.0/22\n - 8.213.176.0/20\n - 8.213.176.0/21\n - 8.213.184.0/21\n - 8.213.192.0/18\n - 8.213.192.0/19\n - 8.213.224.0/19\n - 8.213.251.0/24\n - 8.213.252.0/24\n - 8.213.253.0/24\n - 8.213.64.0/18\n - 8.214.0.0/16\n - 8.214.0.0/17\n - 8.214.128.0/17\n - 8.215.0.0/16\n - 8.215.0.0/17\n - 8.215.128.0/17\n - 8.215.160.0/24\n - 8.215.162.0/23\n - 8.215.168.0/24\n - 8.215.169.0/24\n - 8.216.0.0/17\n - 8.216.0.0/18\n - 8.216.128.0/17\n - 8.216.128.0/18\n - 8.216.148.0/24\n - 8.216.192.0/18\n - 8.216.64.0/18\n - 8.216.69.0/24\n - 8.216.74.0/24\n - 8.217.0.0/16\n - 8.217.0.0/17\n - 8.217.128.0/17\n - 8.218.0.0/16\n - 8.218.0.0/17\n - 8.218.128.0/17\n - 8.219.0.0/16\n - 8.219.0.0/17\n - 8.219.128.0/17\n - 8.219.40.0/21\n - 8.220.116.0/24\n - 8.220.128.0/18\n - 8.220.128.0/19\n - 8.220.147.0/24\n - 8.220.160.0/19\n - 8.220.192.0/18\n - 8.220.192.0/19\n - 8.220.224.0/19\n - 8.220.229.0/24\n - 8.220.64.0/18\n - 8.220.64.0/19\n - 8.220.96.0/19\n - 8.221.0.0/17\n - 8.221.0.0/18\n - 8.221.0.0/21\n - 8.221.128.0/17\n - 8.221.128.0/18\n - 8.221.184.0/22\n - 8.221.188.0/22\n - 8.221.192.0/18\n - 8.221.192.0/21\n - 8.221.200.0/21\n - 8.221.208.0/21\n - 8.221.216.0/21\n - 8.221.48.0/21\n - 8.221.56.0/21\n - 8.221.64.0/18\n - 8.221.8.0/21\n - 8.222.0.0/20\n - 8.222.0.0/21\n - 8.222.112.0/20\n - 8.222.128.0/17\n - 8.222.128.0/18\n - 8.222.16.0/20\n - 8.222.16.0/21\n - 8.222.192.0/18\n - 8.222.24.0/21\n - 8.222.32.0/20\n - 8.222.32.0/21\n - 8.222.40.0/21\n - 8.222.48.0/20\n - 8.222.48.0/21\n - 8.222.56.0/21\n - 8.222.64.0/20\n - 8.222.64.0/21\n - 8.222.72.0/21\n - 8.222.8.0/21\n - 8.222.80.0/20\n - 8.222.80.0/21\n - 8.222.88.0/21\n - 8.222.96.0/19\n - 8.222.96.0/20\n - 8.223.0.0/17\n - 8.223.0.0/18\n - 8.223.128.0/17\n - 8.223.128.0/18\n - 8.223.192.0/18\n - 8.223.64.0/18\n"
},
{
"path": "data/crawlers/applebot.yaml",
"content": "# Indexing for search and Siri\n# https://support.apple.com/en-us/119829\n- name: applebot\n user_agent_regex: Applebot\n action: ALLOW\n # https://search.developer.apple.com/applebot.json\n remote_addresses:\n [\n \"17.241.208.160/27\",\n \"17.241.193.160/27\",\n \"17.241.200.160/27\",\n \"17.22.237.0/24\",\n \"17.22.245.0/24\",\n \"17.22.253.0/24\",\n \"17.241.75.0/24\",\n \"17.241.219.0/24\",\n \"17.241.227.0/24\",\n \"17.246.15.0/24\",\n \"17.246.19.0/24\",\n \"17.246.23.0/24\",\n ]\n"
},
{
"path": "data/crawlers/bingbot.yaml",
"content": "- name: bingbot\n user_agent_regex: \\+http\\://www\\.bing\\.com/bingbot\\.htm\n action: ALLOW\n # https://www.bing.com/toolbox/bingbot.json\n remote_addresses:\n [\n \"157.55.39.0/24\",\n \"207.46.13.0/24\",\n \"40.77.167.0/24\",\n \"13.66.139.0/24\",\n \"13.66.144.0/24\",\n \"52.167.144.0/24\",\n \"13.67.10.16/28\",\n \"13.69.66.240/28\",\n \"13.71.172.224/28\",\n \"139.217.52.0/28\",\n \"191.233.204.224/28\",\n \"20.36.108.32/28\",\n \"20.43.120.16/28\",\n \"40.79.131.208/28\",\n \"40.79.186.176/28\",\n \"52.231.148.0/28\",\n \"20.79.107.240/28\",\n \"51.105.67.0/28\",\n \"20.125.163.80/28\",\n \"40.77.188.0/22\",\n \"65.55.210.0/24\",\n \"199.30.24.0/23\",\n \"40.77.202.0/24\",\n \"40.77.139.0/25\",\n \"20.74.197.0/28\",\n \"20.15.133.160/27\",\n \"40.77.177.0/24\",\n \"40.77.178.0/23\",\n ]\n"
},
{
"path": "data/crawlers/commoncrawl.yaml",
"content": "- name: common-crawl\n user_agent_regex: CCBot\n action: ALLOW\n # https://index.commoncrawl.org/ccbot.json\n remote_addresses:\n [\n \"2600:1f28:365:80b0::/60\",\n \"18.97.9.168/29\",\n \"18.97.14.80/29\",\n \"18.97.14.88/30\",\n \"98.85.178.216/32\",\n ]\n"
},
{
"path": "data/crawlers/duckduckbot.yaml",
"content": "- name: duckduckbot\n user_agent_regex: DuckDuckBot/1\\.1; \\(\\+http\\://duckduckgo\\.com/duckduckbot\\.html\\)\n action: ALLOW\n # https://duckduckgo.com/duckduckgo-help-pages/results/duckduckbot\n remote_addresses:\n [\n \"57.152.72.128/32\",\n \"51.8.253.152/32\",\n \"40.80.242.63/32\",\n \"20.12.141.99/32\",\n \"20.49.136.28/32\",\n \"51.116.131.221/32\",\n \"51.107.40.209/32\",\n \"20.40.133.240/32\",\n \"20.50.168.91/32\",\n \"51.120.48.122/32\",\n \"20.193.45.113/32\",\n \"40.76.173.151/32\",\n \"40.76.163.7/32\",\n \"20.185.79.47/32\",\n \"52.142.26.175/32\",\n \"20.185.79.15/32\",\n \"52.142.24.149/32\",\n \"40.76.162.208/32\",\n \"40.76.163.23/32\",\n \"40.76.162.191/32\",\n \"40.76.162.247/32\",\n \"40.88.21.235/32\",\n \"20.191.45.212/32\",\n \"52.146.59.12/32\",\n \"52.146.59.156/32\",\n \"52.146.59.154/32\",\n \"52.146.58.236/32\",\n \"20.62.224.44/32\",\n \"51.104.180.53/32\",\n \"51.104.180.47/32\",\n \"51.104.180.26/32\",\n \"51.104.146.225/32\",\n \"51.104.146.235/32\",\n \"20.73.202.147/32\",\n \"20.73.132.240/32\",\n \"20.71.12.143/32\",\n \"20.56.197.58/32\",\n \"20.56.197.63/32\",\n \"20.43.150.93/32\",\n \"20.43.150.85/32\",\n \"20.44.222.1/32\",\n \"40.89.243.175/32\",\n \"13.89.106.77/32\",\n \"52.143.242.6/32\",\n \"52.143.241.111/32\",\n \"52.154.60.82/32\",\n \"20.197.209.11/32\",\n \"20.197.209.27/32\",\n \"20.226.133.105/32\",\n \"191.234.216.4/32\",\n \"191.234.216.178/32\",\n \"20.53.92.211/32\",\n \"20.53.91.2/32\",\n \"20.207.99.197/32\",\n \"20.207.97.190/32\",\n \"40.81.250.205/32\",\n \"40.64.106.11/32\",\n \"40.64.105.247/32\",\n \"20.72.242.93/32\",\n \"20.99.255.235/32\",\n \"20.113.3.121/32\",\n \"52.224.16.221/32\",\n \"52.224.21.53/32\",\n \"52.224.20.204/32\",\n \"52.224.21.19/32\",\n \"52.224.20.249/32\",\n \"52.224.20.203/32\",\n \"52.224.20.190/32\",\n \"52.224.16.229/32\",\n \"52.224.21.20/32\",\n \"52.146.63.80/32\",\n \"52.224.20.227/32\",\n \"52.224.20.193/32\",\n \"52.190.37.160/32\",\n \"52.224.21.23/32\",\n \"52.224.20.223/32\",\n \"52.224.20.181/32\",\n \"52.224.21.49/32\",\n \"52.224.21.55/32\",\n \"52.224.21.61/32\",\n \"52.224.19.152/32\",\n \"52.224.20.186/32\",\n \"52.224.21.27/32\",\n \"52.224.21.51/32\",\n \"52.224.20.174/32\",\n \"52.224.21.4/32\",\n \"51.104.164.109/32\",\n \"51.104.167.71/32\",\n \"51.104.160.177/32\",\n \"51.104.162.149/32\",\n \"51.104.167.95/32\",\n \"51.104.167.54/32\",\n \"51.104.166.111/32\",\n \"51.104.167.88/32\",\n \"51.104.161.32/32\",\n \"51.104.163.250/32\",\n \"51.104.164.189/32\",\n \"51.104.167.19/32\",\n \"51.104.160.167/32\",\n \"51.104.167.110/32\",\n \"20.191.44.119/32\",\n \"51.104.167.104/32\",\n \"20.191.44.234/32\",\n \"51.104.164.215/32\",\n \"51.104.167.52/32\",\n \"20.191.44.22/32\",\n \"51.104.167.87/32\",\n \"51.104.167.96/32\",\n \"20.191.44.16/32\",\n \"51.104.167.61/32\",\n \"51.104.164.147/32\",\n \"20.50.48.159/32\",\n \"40.114.182.172/32\",\n \"20.50.50.130/32\",\n \"20.50.50.163/32\",\n \"20.50.50.46/32\",\n \"40.114.182.153/32\",\n \"20.50.50.118/32\",\n \"20.50.49.55/32\",\n \"20.50.49.25/32\",\n \"40.114.183.251/32\",\n \"20.50.50.123/32\",\n \"20.50.49.237/32\",\n \"20.50.48.192/32\",\n \"20.50.50.134/32\",\n \"51.138.90.233/32\",\n \"40.114.183.196/32\",\n \"20.50.50.146/32\",\n \"40.114.183.88/32\",\n \"20.50.50.145/32\",\n \"20.50.50.121/32\",\n \"20.50.49.40/32\",\n \"51.138.90.206/32\",\n \"40.114.182.45/32\",\n \"51.138.90.161/32\",\n \"20.50.49.0/32\",\n \"40.119.232.215/32\",\n \"104.43.55.167/32\",\n \"40.119.232.251/32\",\n \"40.119.232.50/32\",\n \"40.119.232.146/32\",\n \"40.119.232.218/32\",\n \"104.43.54.127/32\",\n \"104.43.55.117/32\",\n \"104.43.55.116/32\",\n \"104.43.55.166/32\",\n \"52.154.169.50/32\",\n \"52.154.171.70/32\",\n \"52.154.170.229/32\",\n \"52.154.170.113/32\",\n \"52.154.171.44/32\",\n \"52.154.172.2/32\",\n \"52.143.244.81/32\",\n \"52.154.171.87/32\",\n \"52.154.171.250/32\",\n \"52.154.170.28/32\",\n \"52.154.170.122/32\",\n \"52.143.243.117/32\",\n \"52.143.247.235/32\",\n \"52.154.171.235/32\",\n \"52.154.171.196/32\",\n \"52.154.171.0/32\",\n \"52.154.170.243/32\",\n \"52.154.170.26/32\",\n \"52.154.169.200/32\",\n \"52.154.170.96/32\",\n \"52.154.170.88/32\",\n \"52.154.171.150/32\",\n \"52.154.171.205/32\",\n \"52.154.170.117/32\",\n \"52.154.170.209/32\",\n \"191.235.202.48/32\",\n \"191.233.3.202/32\",\n \"191.235.201.214/32\",\n \"191.233.3.197/32\",\n \"191.235.202.38/32\",\n \"20.53.78.144/32\",\n \"20.193.24.10/32\",\n \"20.53.78.236/32\",\n \"20.53.78.138/32\",\n \"20.53.78.123/32\",\n \"20.53.78.106/32\",\n \"20.193.27.215/32\",\n \"20.193.25.197/32\",\n \"20.193.12.126/32\",\n \"20.193.24.251/32\",\n \"20.204.242.101/32\",\n \"20.207.72.113/32\",\n \"20.204.242.19/32\",\n \"20.219.45.67/32\",\n \"20.207.72.11/32\",\n \"20.219.45.190/32\",\n \"20.204.243.55/32\",\n \"20.204.241.148/32\",\n \"20.207.72.110/32\",\n \"20.204.240.172/32\",\n \"20.207.72.21/32\",\n \"20.204.246.81/32\",\n \"20.207.107.181/32\",\n \"20.204.246.254/32\",\n \"20.219.43.246/32\",\n \"52.149.25.43/32\",\n \"52.149.61.51/32\",\n \"52.149.58.139/32\",\n \"52.149.60.38/32\",\n \"52.148.165.38/32\",\n \"52.143.95.162/32\",\n \"52.149.56.151/32\",\n \"52.149.30.45/32\",\n \"52.149.58.173/32\",\n \"52.143.95.204/32\",\n \"52.149.28.83/32\",\n \"52.149.58.69/32\",\n \"52.148.161.87/32\",\n \"52.149.58.27/32\",\n \"52.149.28.18/32\",\n \"20.79.226.26/32\",\n \"20.79.239.66/32\",\n \"20.79.238.198/32\",\n \"20.113.14.159/32\",\n \"20.75.144.152/32\",\n \"20.43.172.120/32\",\n \"20.53.134.160/32\",\n \"20.201.15.208/32\",\n \"20.93.28.24/32\",\n \"20.61.34.40/32\",\n \"52.242.224.168/32\",\n \"20.80.129.80/32\",\n \"20.195.108.47/32\",\n \"4.195.133.120/32\",\n \"4.228.76.163/32\",\n \"4.182.131.108/32\",\n \"4.209.224.56/32\",\n \"108.141.83.74/32\",\n \"4.213.46.14/32\",\n \"172.169.17.165/32\",\n \"51.8.71.117/32\",\n \"20.3.1.178/32\",\n \"52.149.56.151/32\",\n \"52.149.30.45/32\",\n \"52.149.58.173/32\",\n \"52.143.95.204/32\",\n \"52.149.28.83/32\",\n \"52.149.58.69/32\",\n \"52.148.161.87/32\",\n \"52.149.58.27/32\",\n \"52.149.28.18/32\",\n \"20.79.226.26/32\",\n \"20.79.239.66/32\",\n \"20.79.238.198/32\",\n \"20.113.14.159/32\",\n \"20.75.144.152/32\",\n \"20.43.172.120/32\",\n \"20.53.134.160/32\",\n \"20.201.15.208/32\",\n \"20.93.28.24/32\",\n \"20.61.34.40/32\",\n \"52.242.224.168/32\",\n \"20.80.129.80/32\",\n \"20.195.108.47/32\",\n \"4.195.133.120/32\",\n \"4.228.76.163/32\",\n \"4.182.131.108/32\",\n \"4.209.224.56/32\",\n \"108.141.83.74/32\",\n \"4.213.46.14/32\",\n \"172.169.17.165/32\",\n \"51.8.71.117/32\",\n \"20.3.1.178/32\",\n ]\n"
},
{
"path": "data/crawlers/googlebot.yaml",
"content": "- name: googlebot\n user_agent_regex: \\+http\\://www\\.google\\.com/bot\\.html\n action: ALLOW\n # https://developers.google.com/static/search/apis/ipranges/googlebot.json\n remote_addresses:\n [\n \"2001:4860:4801:10::/64\",\n \"2001:4860:4801:11::/64\",\n \"2001:4860:4801:12::/64\",\n \"2001:4860:4801:13::/64\",\n \"2001:4860:4801:14::/64\",\n \"2001:4860:4801:15::/64\",\n \"2001:4860:4801:16::/64\",\n \"2001:4860:4801:17::/64\",\n \"2001:4860:4801:18::/64\",\n \"2001:4860:4801:19::/64\",\n \"2001:4860:4801:1a::/64\",\n \"2001:4860:4801:1b::/64\",\n \"2001:4860:4801:1c::/64\",\n \"2001:4860:4801:1d::/64\",\n \"2001:4860:4801:1e::/64\",\n \"2001:4860:4801:1f::/64\",\n \"2001:4860:4801:20::/64\",\n \"2001:4860:4801:21::/64\",\n \"2001:4860:4801:22::/64\",\n \"2001:4860:4801:23::/64\",\n \"2001:4860:4801:24::/64\",\n \"2001:4860:4801:25::/64\",\n \"2001:4860:4801:26::/64\",\n \"2001:4860:4801:27::/64\",\n \"2001:4860:4801:28::/64\",\n \"2001:4860:4801:29::/64\",\n \"2001:4860:4801:2::/64\",\n \"2001:4860:4801:2a::/64\",\n \"2001:4860:4801:2b::/64\",\n \"2001:4860:4801:2c::/64\",\n \"2001:4860:4801:2d::/64\",\n \"2001:4860:4801:2e::/64\",\n \"2001:4860:4801:2f::/64\",\n \"2001:4860:4801:31::/64\",\n \"2001:4860:4801:32::/64\",\n \"2001:4860:4801:33::/64\",\n \"2001:4860:4801:34::/64\",\n \"2001:4860:4801:35::/64\",\n \"2001:4860:4801:36::/64\",\n \"2001:4860:4801:37::/64\",\n \"2001:4860:4801:38::/64\",\n \"2001:4860:4801:39::/64\",\n \"2001:4860:4801:3a::/64\",\n \"2001:4860:4801:3b::/64\",\n \"2001:4860:4801:3c::/64\",\n \"2001:4860:4801:3d::/64\",\n \"2001:4860:4801:3e::/64\",\n \"2001:4860:4801:40::/64\",\n \"2001:4860:4801:41::/64\",\n \"2001:4860:4801:42::/64\",\n \"2001:4860:4801:43::/64\",\n \"2001:4860:4801:44::/64\",\n \"2001:4860:4801:45::/64\",\n \"2001:4860:4801:46::/64\",\n \"2001:4860:4801:47::/64\",\n \"2001:4860:4801:48::/64\",\n \"2001:4860:4801:49::/64\",\n \"2001:4860:4801:4a::/64\",\n \"2001:4860:4801:4b::/64\",\n \"2001:4860:4801:4c::/64\",\n \"2001:4860:4801:50::/64\",\n \"2001:4860:4801:51::/64\",\n \"2001:4860:4801:52::/64\",\n \"2001:4860:4801:53::/64\",\n \"2001:4860:4801:54::/64\",\n \"2001:4860:4801:55::/64\",\n \"2001:4860:4801:56::/64\",\n \"2001:4860:4801:60::/64\",\n \"2001:4860:4801:61::/64\",\n \"2001:4860:4801:62::/64\",\n \"2001:4860:4801:63::/64\",\n \"2001:4860:4801:64::/64\",\n \"2001:4860:4801:65::/64\",\n \"2001:4860:4801:66::/64\",\n \"2001:4860:4801:67::/64\",\n \"2001:4860:4801:68::/64\",\n \"2001:4860:4801:69::/64\",\n \"2001:4860:4801:6a::/64\",\n \"2001:4860:4801:6b::/64\",\n \"2001:4860:4801:6c::/64\",\n \"2001:4860:4801:6d::/64\",\n \"2001:4860:4801:6e::/64\",\n \"2001:4860:4801:6f::/64\",\n \"2001:4860:4801:70::/64\",\n \"2001:4860:4801:71::/64\",\n \"2001:4860:4801:72::/64\",\n \"2001:4860:4801:73::/64\",\n \"2001:4860:4801:74::/64\",\n \"2001:4860:4801:75::/64\",\n \"2001:4860:4801:76::/64\",\n \"2001:4860:4801:77::/64\",\n \"2001:4860:4801:78::/64\",\n \"2001:4860:4801:79::/64\",\n \"2001:4860:4801:80::/64\",\n \"2001:4860:4801:81::/64\",\n \"2001:4860:4801:82::/64\",\n \"2001:4860:4801:83::/64\",\n \"2001:4860:4801:84::/64\",\n \"2001:4860:4801:85::/64\",\n \"2001:4860:4801:86::/64\",\n \"2001:4860:4801:87::/64\",\n \"2001:4860:4801:88::/64\",\n \"2001:4860:4801:90::/64\",\n \"2001:4860:4801:91::/64\",\n \"2001:4860:4801:92::/64\",\n \"2001:4860:4801:93::/64\",\n \"2001:4860:4801:94::/64\",\n \"2001:4860:4801:95::/64\",\n \"2001:4860:4801:96::/64\",\n \"2001:4860:4801:a0::/64\",\n \"2001:4860:4801:a1::/64\",\n \"2001:4860:4801:a2::/64\",\n \"2001:4860:4801:a3::/64\",\n \"2001:4860:4801:a4::/64\",\n \"2001:4860:4801:a5::/64\",\n \"2001:4860:4801:c::/64\",\n \"2001:4860:4801:f::/64\",\n \"192.178.5.0/27\",\n \"192.178.6.0/27\",\n \"192.178.6.128/27\",\n \"192.178.6.160/27\",\n \"192.178.6.192/27\",\n \"192.178.6.32/27\",\n \"192.178.6.64/27\",\n \"192.178.6.96/27\",\n \"34.100.182.96/28\",\n \"34.101.50.144/28\",\n \"34.118.254.0/28\",\n \"34.118.66.0/28\",\n \"34.126.178.96/28\",\n \"34.146.150.144/28\",\n \"34.147.110.144/28\",\n \"34.151.74.144/28\",\n \"34.152.50.64/28\",\n \"34.154.114.144/28\",\n \"34.155.98.32/28\",\n \"34.165.18.176/28\",\n \"34.175.160.64/28\",\n \"34.176.130.16/28\",\n \"34.22.85.0/27\",\n \"34.64.82.64/28\",\n \"34.65.242.112/28\",\n \"34.80.50.80/28\",\n \"34.88.194.0/28\",\n \"34.89.10.80/28\",\n \"34.89.198.80/28\",\n \"34.96.162.48/28\",\n \"35.247.243.240/28\",\n \"66.249.64.0/27\",\n \"66.249.64.128/27\",\n \"66.249.64.160/27\",\n \"66.249.64.224/27\",\n \"66.249.64.32/27\",\n \"66.249.64.64/27\",\n \"66.249.64.96/27\",\n \"66.249.65.0/27\",\n \"66.249.65.128/27\",\n \"66.249.65.160/27\",\n \"66.249.65.192/27\",\n \"66.249.65.224/27\",\n \"66.249.65.32/27\",\n \"66.249.65.64/27\",\n \"66.249.65.96/27\",\n \"66.249.66.0/27\",\n \"66.249.66.128/27\",\n \"66.249.66.160/27\",\n \"66.249.66.192/27\",\n \"66.249.66.224/27\",\n \"66.249.66.32/27\",\n \"66.249.66.64/27\",\n \"66.249.66.96/27\",\n \"66.249.68.0/27\",\n \"66.249.68.128/27\",\n \"66.249.68.32/27\",\n \"66.249.68.64/27\",\n \"66.249.68.96/27\",\n \"66.249.69.0/27\",\n \"66.249.69.128/27\",\n \"66.249.69.160/27\",\n \"66.249.69.192/27\",\n \"66.249.69.224/27\",\n \"66.249.69.32/27\",\n \"66.249.69.64/27\",\n \"66.249.69.96/27\",\n \"66.249.70.0/27\",\n \"66.249.70.128/27\",\n \"66.249.70.160/27\",\n \"66.249.70.192/27\",\n \"66.249.70.224/27\",\n \"66.249.70.32/27\",\n \"66.249.70.64/27\",\n \"66.249.70.96/27\",\n \"66.249.71.0/27\",\n \"66.249.71.128/27\",\n \"66.249.71.160/27\",\n \"66.249.71.192/27\",\n \"66.249.71.224/27\",\n \"66.249.71.32/27\",\n \"66.249.71.64/27\",\n \"66.249.71.96/27\",\n \"66.249.72.0/27\",\n \"66.249.72.128/27\",\n \"66.249.72.160/27\",\n \"66.249.72.192/27\",\n \"66.249.72.224/27\",\n \"66.249.72.32/27\",\n \"66.249.72.64/27\",\n \"66.249.72.96/27\",\n \"66.249.73.0/27\",\n \"66.249.73.128/27\",\n \"66.249.73.160/27\",\n \"66.249.73.192/27\",\n \"66.249.73.224/27\",\n \"66.249.73.32/27\",\n \"66.249.73.64/27\",\n \"66.249.73.96/27\",\n \"66.249.74.0/27\",\n \"66.249.74.128/27\",\n \"66.249.74.160/27\",\n \"66.249.74.192/27\",\n \"66.249.74.32/27\",\n \"66.249.74.64/27\",\n \"66.249.74.96/27\",\n \"66.249.75.0/27\",\n \"66.249.75.128/27\",\n \"66.249.75.160/27\",\n \"66.249.75.192/27\",\n \"66.249.75.224/27\",\n \"66.249.75.32/27\",\n \"66.249.75.64/27\",\n \"66.249.75.96/27\",\n \"66.249.76.0/27\",\n \"66.249.76.128/27\",\n \"66.249.76.160/27\",\n \"66.249.76.192/27\",\n \"66.249.76.224/27\",\n \"66.249.76.32/27\",\n \"66.249.76.64/27\",\n \"66.249.76.96/27\",\n \"66.249.77.0/27\",\n \"66.249.77.128/27\",\n \"66.249.77.160/27\",\n \"66.249.77.192/27\",\n \"66.249.77.224/27\",\n \"66.249.77.32/27\",\n \"66.249.77.64/27\",\n \"66.249.77.96/27\",\n \"66.249.78.0/27\",\n \"66.249.78.32/27\",\n \"66.249.79.0/27\",\n \"66.249.79.128/27\",\n \"66.249.79.160/27\",\n \"66.249.79.192/27\",\n \"66.249.79.224/27\",\n \"66.249.79.32/27\",\n \"66.249.79.64/27\",\n \"66.249.79.96/27\",\n ]\n"
},
{
"path": "data/crawlers/huawei-cloud.yaml",
"content": "- name: huawei-cloud\n action: DENY\n # Updated 2025-08-20 from IP addresses for AS136907\n remote_addresses:\n - 1.178.32.0/20\n - 1.178.48.0/20\n - 101.44.0.0/20\n - 101.44.144.0/20\n - 101.44.16.0/20\n - 101.44.160.0/20\n - 101.44.173.0/24\n - 101.44.176.0/20\n - 101.44.192.0/20\n - 101.44.208.0/22\n - 101.44.212.0/22\n - 101.44.216.0/22\n - 101.44.220.0/22\n - 101.44.224.0/22\n - 101.44.228.0/22\n - 101.44.232.0/22\n - 101.44.236.0/22\n - 101.44.240.0/22\n - 101.44.244.0/22\n - 101.44.248.0/22\n - 101.44.252.0/24\n - 101.44.253.0/24\n - 101.44.254.0/24\n - 101.44.255.0/24\n - 101.44.32.0/20\n - 101.44.48.0/20\n - 101.44.64.0/20\n - 101.44.80.0/20\n - 101.44.96.0/20\n - 101.46.0.0/20\n - 101.46.128.0/21\n - 101.46.136.0/21\n - 101.46.144.0/21\n - 101.46.152.0/21\n - 101.46.160.0/21\n - 101.46.168.0/21\n - 101.46.176.0/21\n - 101.46.184.0/21\n - 101.46.192.0/21\n - 101.46.200.0/21\n - 101.46.208.0/21\n - 101.46.216.0/21\n - 101.46.224.0/22\n - 101.46.232.0/22\n - 101.46.236.0/22\n - 101.46.240.0/22\n - 101.46.244.0/22\n - 101.46.248.0/22\n - 101.46.252.0/24\n - 101.46.253.0/24\n - 101.46.254.0/24\n - 101.46.255.0/24\n - 101.46.32.0/20\n - 101.46.48.0/20\n - 101.46.64.0/20\n - 101.46.80.0/20\n - 103.198.203.0/24\n - 103.215.0.0/24\n - 103.215.1.0/24\n - 103.215.3.0/24\n - 103.240.156.0/22\n - 103.240.157.0/24\n - 103.255.60.0/22\n - 103.255.60.0/24\n - 103.255.61.0/24\n - 103.255.62.0/24\n - 103.255.63.0/24\n - 103.40.100.0/23\n - 103.84.110.0/24\n - 110.238.100.0/22\n - 110.238.104.0/21\n - 110.238.112.0/21\n - 110.238.120.0/22\n - 110.238.124.0/22\n - 110.238.64.0/21\n - 110.238.72.0/21\n - 110.238.80.0/20\n - 110.238.96.0/24\n - 110.238.98.0/24\n - 110.238.99.0/24\n - 110.239.127.0/24\n - 110.239.184.0/22\n - 110.239.188.0/23\n - 110.239.190.0/23\n - 110.239.64.0/19\n - 110.239.96.0/19\n - 110.41.208.0/24\n - 110.41.209.0/24\n - 110.41.210.0/24\n - 111.119.192.0/20\n - 111.119.208.0/20\n - 111.119.224.0/20\n - 111.119.240.0/20\n - 111.91.0.0/20\n - 111.91.112.0/20\n - 111.91.16.0/20\n - 111.91.32.0/20\n - 111.91.48.0/20\n - 111.91.64.0/20\n - 111.91.80.0/20\n - 111.91.96.0/20\n - 114.119.128.0/19\n - 114.119.160.0/21\n - 114.119.168.0/24\n - 114.119.169.0/24\n - 114.119.170.0/24\n - 114.119.171.0/24\n - 114.119.172.0/22\n - 114.119.176.0/20\n - 115.30.32.0/20\n - 115.30.48.0/20\n - 119.12.160.0/20\n - 119.13.112.0/20\n - 119.13.160.0/24\n - 119.13.161.0/24\n - 119.13.162.0/23\n - 119.13.163.0/24\n - 119.13.164.0/22\n - 119.13.168.0/21\n - 119.13.168.0/24\n - 119.13.169.0/24\n - 119.13.170.0/24\n - 119.13.172.0/24\n - 119.13.173.0/24\n - 119.13.32.0/22\n - 119.13.36.0/22\n - 119.13.64.0/24\n - 119.13.65.0/24\n - 119.13.66.0/23\n - 119.13.68.0/22\n - 119.13.72.0/22\n - 119.13.76.0/22\n - 119.13.80.0/21\n - 119.13.88.0/22\n - 119.13.92.0/22\n - 119.13.96.0/20\n - 119.8.0.0/21\n - 119.8.128.0/24\n - 119.8.129.0/24\n - 119.8.130.0/23\n - 119.8.132.0/22\n - 119.8.136.0/21\n - 119.8.144.0/20\n - 119.8.160.0/19\n - 119.8.18.0/24\n - 119.8.192.0/20\n - 119.8.192.0/21\n - 119.8.200.0/21\n - 119.8.208.0/20\n - 119.8.21.0/24\n - 119.8.22.0/24\n - 119.8.224.0/24\n - 119.8.227.0/24\n - 119.8.228.0/22\n - 119.8.23.0/24\n - 119.8.232.0/21\n - 119.8.24.0/21\n - 119.8.240.0/23\n - 119.8.242.0/23\n - 119.8.244.0/24\n - 119.8.245.0/24\n - 119.8.246.0/24\n - 119.8.247.0/24\n - 119.8.248.0/24\n - 119.8.249.0/24\n - 119.8.250.0/24\n - 119.8.253.0/24\n - 119.8.254.0/23\n - 119.8.32.0/19\n - 119.8.4.0/24\n - 119.8.64.0/22\n - 119.8.68.0/24\n - 119.8.69.0/24\n - 119.8.70.0/24\n - 119.8.71.0/24\n - 119.8.72.0/21\n - 119.8.8.0/21\n - 119.8.80.0/20\n - 119.8.96.0/19\n - 121.91.152.0/21\n - 121.91.168.0/21\n - 121.91.200.0/21\n - 121.91.200.0/24\n - 121.91.201.0/24\n - 121.91.204.0/24\n - 121.91.205.0/24\n - 122.8.128.0/20\n - 122.8.144.0/20\n - 122.8.160.0/20\n - 122.8.176.0/21\n - 122.8.184.0/22\n - 122.8.188.0/22\n - 124.243.128.0/18\n - 124.243.156.0/24\n - 124.243.157.0/24\n - 124.243.158.0/24\n - 124.243.159.0/24\n - 124.71.248.0/24\n - 124.71.249.0/24\n - 124.71.250.0/24\n - 124.71.252.0/24\n - 124.71.253.0/24\n - 124.81.0.0/20\n - 124.81.112.0/20\n - 124.81.128.0/20\n - 124.81.144.0/20\n - 124.81.16.0/20\n - 124.81.160.0/20\n - 124.81.176.0/20\n - 124.81.192.0/20\n - 124.81.208.0/20\n - 124.81.224.0/20\n - 124.81.240.0/20\n - 124.81.32.0/20\n - 124.81.48.0/20\n - 124.81.64.0/20\n - 124.81.80.0/20\n - 124.81.96.0/20\n - 139.9.98.0/24\n - 139.9.99.0/24\n - 14.137.132.0/22\n - 14.137.136.0/22\n - 14.137.140.0/22\n - 14.137.152.0/24\n - 14.137.153.0/24\n - 14.137.154.0/24\n - 14.137.155.0/24\n - 14.137.156.0/24\n - 14.137.157.0/24\n - 14.137.161.0/24\n - 14.137.163.0/24\n - 14.137.169.0/24\n - 14.137.170.0/23\n - 14.137.172.0/22\n - 146.174.128.0/20\n - 146.174.144.0/20\n - 146.174.160.0/20\n - 146.174.176.0/20\n - 148.145.160.0/20\n - 148.145.192.0/20\n - 148.145.208.0/20\n - 148.145.224.0/23\n - 148.145.234.0/23\n - 148.145.236.0/23\n - 148.145.238.0/23\n - 149.232.128.0/20\n - 149.232.144.0/20\n - 150.40.128.0/20\n - 150.40.144.0/20\n - 150.40.160.0/20\n - 150.40.176.0/20\n - 150.40.182.0/24\n - 150.40.192.0/20\n - 150.40.208.0/20\n - 150.40.224.0/20\n - 150.40.240.0/20\n - 154.220.192.0/19\n - 154.81.16.0/20\n - 154.83.0.0/23\n - 154.86.32.0/20\n - 154.86.48.0/20\n - 154.93.100.0/23\n - 154.93.104.0/23\n - 156.227.22.0/23\n - 156.230.32.0/21\n - 156.230.40.0/21\n - 156.230.64.0/18\n - 156.232.16.0/20\n - 156.240.128.0/18\n - 156.249.32.0/20\n - 156.253.16.0/20\n - 157.254.211.0/24\n - 157.254.212.0/24\n - 159.138.0.0/20\n - 159.138.112.0/21\n - 159.138.114.0/24\n - 159.138.120.0/22\n - 159.138.124.0/24\n - 159.138.125.0/24\n - 159.138.126.0/23\n - 159.138.128.0/20\n - 159.138.144.0/20\n - 159.138.152.0/21\n - 159.138.16.0/22\n - 159.138.160.0/20\n - 159.138.176.0/23\n - 159.138.178.0/24\n - 159.138.179.0/24\n - 159.138.180.0/24\n - 159.138.181.0/24\n - 159.138.182.0/23\n - 159.138.188.0/23\n - 159.138.190.0/23\n - 159.138.192.0/20\n - 159.138.20.0/22\n - 159.138.208.0/21\n - 159.138.216.0/22\n - 159.138.220.0/23\n - 159.138.224.0/20\n - 159.138.24.0/21\n - 159.138.240.0/20\n - 159.138.32.0/20\n - 159.138.48.0/20\n - 159.138.64.0/21\n - 159.138.67.0/24\n - 159.138.76.0/24\n - 159.138.77.0/24\n - 159.138.78.0/24\n - 159.138.79.0/24\n - 159.138.80.0/20\n - 159.138.96.0/20\n - 166.108.192.0/20\n - 166.108.208.0/20\n - 166.108.224.0/20\n - 166.108.240.0/20\n - 176.52.128.0/20\n - 176.52.144.0/20\n - 180.87.192.0/20\n - 180.87.208.0/20\n - 180.87.224.0/20\n - 180.87.240.0/20\n - 182.160.0.0/20\n - 182.160.16.0/24\n - 182.160.17.0/24\n - 182.160.18.0/23\n - 182.160.20.0/22\n - 182.160.20.0/24\n - 182.160.24.0/21\n - 182.160.36.0/22\n - 182.160.49.0/24\n - 182.160.52.0/22\n - 182.160.56.0/21\n - 182.160.56.0/24\n - 182.160.57.0/24\n - 182.160.58.0/24\n - 182.160.59.0/24\n - 182.160.60.0/24\n - 182.160.61.0/24\n - 182.160.62.0/24\n - 183.87.112.0/20\n - 183.87.128.0/20\n - 183.87.144.0/20\n - 183.87.32.0/20\n - 183.87.48.0/20\n - 183.87.64.0/20\n - 183.87.80.0/20\n - 183.87.96.0/20\n - 188.119.192.0/20\n - 188.119.208.0/20\n - 188.119.224.0/20\n - 188.119.240.0/20\n - 188.239.0.0/20\n - 188.239.16.0/20\n - 188.239.32.0/20\n - 188.239.48.0/20\n - 189.1.192.0/20\n - 189.1.208.0/20\n - 189.1.224.0/20\n - 189.1.240.0/20\n - 189.28.112.0/20\n - 189.28.96.0/20\n - 190.92.192.0/19\n - 190.92.224.0/19\n - 190.92.248.0/24\n - 190.92.252.0/24\n - 190.92.253.0/24\n - 190.92.254.0/24\n - 201.77.32.0/20\n - 202.170.88.0/21\n - 202.76.128.0/20\n - 202.76.144.0/20\n - 202.76.160.0/20\n - 202.76.176.0/20\n - 203.123.80.0/20\n - 203.167.20.0/23\n - 203.167.22.0/24\n - 212.34.192.0/20\n - 212.34.208.0/20\n - 213.250.128.0/20\n - 213.250.144.0/20\n - 213.250.160.0/20\n - 213.250.176.0/21\n - 213.250.184.0/21\n - 219.83.0.0/20\n - 219.83.112.0/22\n - 219.83.116.0/23\n - 219.83.118.0/23\n - 219.83.121.0/24\n - 219.83.122.0/24\n - 219.83.123.0/24\n - 219.83.124.0/24\n - 219.83.16.0/20\n - 219.83.32.0/20\n - 219.83.76.0/23\n - 2404:a140:43::/48\n - 2405:f080::/39\n - 2405:f080:1::/48\n - 2405:f080:1000::/39\n - 2405:f080:1200::/39\n - 2405:f080:1400::/48\n - 2405:f080:1401::/48\n - 2405:f080:1402::/48\n - 2405:f080:1403::/48\n - 2405:f080:1500::/40\n - 2405:f080:1600::/48\n - 2405:f080:1602::/48\n - 2405:f080:1603::/48\n - 2405:f080:1800::/39\n - 2405:f080:1800::/44\n - 2405:f080:1810::/48\n - 2405:f080:1811::/48\n - 2405:f080:1812::/48\n - 2405:f080:1813::/48\n - 2405:f080:1814::/48\n - 2405:f080:1815::/48\n - 2405:f080:1900::/40\n - 2405:f080:1e02::/47\n - 2405:f080:1e04::/47\n - 2405:f080:1e06::/47\n - 2405:f080:1e1e::/47\n - 2405:f080:1e20::/47\n - 2405:f080:200::/48\n - 2405:f080:2000::/39\n - 2405:f080:201::/48\n - 2405:f080:202::/48\n - 2405:f080:2040::/48\n - 2405:f080:2200::/39\n - 2405:f080:2280::/48\n - 2405:f080:2281::/48\n - 2405:f080:2282::/48\n - 2405:f080:2283::/48\n - 2405:f080:2284::/48\n - 2405:f080:2285::/48\n - 2405:f080:2286::/48\n - 2405:f080:2287::/48\n - 2405:f080:2288::/48\n - 2405:f080:2289::/48\n - 2405:f080:228a::/48\n - 2405:f080:228b::/48\n - 2405:f080:228c::/48\n - 2405:f080:228d::/48\n - 2405:f080:228e::/48\n - 2405:f080:228f::/48\n - 2405:f080:2400::/39\n - 2405:f080:2600::/39\n - 2405:f080:2800::/48\n - 2405:f080:2a00::/48\n - 2405:f080:2e00::/47\n - 2405:f080:3000::/38\n - 2405:f080:3000::/40\n - 2405:f080:3100::/40\n - 2405:f080:3200::/48\n - 2405:f080:3201::/48\n - 2405:f080:3202::/48\n - 2405:f080:3203::/48\n - 2405:f080:3204::/48\n - 2405:f080:3205::/48\n - 2405:f080:3400::/38\n - 2405:f080:3400::/40\n - 2405:f080:3500::/40\n - 2405:f080:3600::/48\n - 2405:f080:3601::/48\n - 2405:f080:3602::/48\n - 2405:f080:3603::/48\n - 2405:f080:3604::/48\n - 2405:f080:3605::/48\n - 2405:f080:400::/39\n - 2405:f080:4000::/40\n - 2405:f080:4100::/48\n - 2405:f080:4102::/48\n - 2405:f080:4103::/48\n - 2405:f080:4104::/48\n - 2405:f080:4200::/40\n - 2405:f080:4300::/40\n - 2405:f080:600::/48\n - 2405:f080:800::/40\n - 2405:f080:810::/44\n - 2405:f080:a00::/39\n - 2405:f080:a11::/48\n - 2405:f080:e02::/48\n - 2405:f080:e03::/48\n - 2405:f080:e04::/47\n - 2405:f080:e05::/48\n - 2405:f080:e06::/48\n - 2405:f080:e07::/48\n - 2405:f080:e0e::/47\n - 2405:f080:e10::/47\n - 2405:f080:edff::/48\n - 27.106.0.0/20\n - 27.106.112.0/20\n - 27.106.16.0/20\n - 27.106.32.0/20\n - 27.106.48.0/20\n - 27.106.64.0/20\n - 27.106.80.0/20\n - 27.106.96.0/20\n - 27.255.0.0/23\n - 27.255.10.0/23\n - 27.255.12.0/23\n - 27.255.14.0/23\n - 27.255.16.0/23\n - 27.255.18.0/23\n - 27.255.2.0/23\n - 27.255.20.0/23\n - 27.255.22.0/23\n - 27.255.26.0/23\n - 27.255.28.0/23\n - 27.255.30.0/23\n - 27.255.32.0/23\n - 27.255.34.0/23\n - 27.255.36.0/23\n - 27.255.38.0/23\n - 27.255.4.0/23\n - 27.255.40.0/23\n - 27.255.42.0/23\n - 27.255.44.0/23\n - 27.255.46.0/23\n - 27.255.48.0/23\n - 27.255.50.0/23\n - 27.255.52.0/23\n - 27.255.54.0/23\n - 27.255.58.0/23\n - 27.255.6.0/23\n - 27.255.60.0/23\n - 27.255.62.0/23\n - 27.255.8.0/23\n - 42.201.128.0/20\n - 42.201.144.0/20\n - 42.201.160.0/20\n - 42.201.176.0/20\n - 42.201.192.0/20\n - 42.201.208.0/20\n - 42.201.224.0/20\n - 42.201.240.0/20\n - 43.225.140.0/22\n - 43.255.104.0/22\n - 45.194.104.0/21\n - 45.199.144.0/22\n - 45.202.128.0/19\n - 45.202.160.0/20\n - 45.202.176.0/21\n - 45.202.184.0/21\n - 45.203.40.0/21\n - 46.250.160.0/20\n - 46.250.176.0/20\n - 49.0.192.0/21\n - 49.0.200.0/21\n - 49.0.224.0/22\n - 49.0.228.0/22\n - 49.0.232.0/21\n - 49.0.240.0/20\n - 62.245.0.0/20\n - 62.245.16.0/20\n - 80.238.128.0/22\n - 80.238.132.0/22\n - 80.238.136.0/22\n - 80.238.140.0/22\n - 80.238.144.0/22\n - 80.238.148.0/22\n - 80.238.152.0/22\n - 80.238.156.0/22\n - 80.238.164.0/22\n - 80.238.164.0/24\n - 80.238.165.0/24\n - 80.238.168.0/22\n - 80.238.168.0/24\n - 80.238.169.0/24\n - 80.238.170.0/24\n - 80.238.171.0/24\n - 80.238.172.0/22\n - 80.238.176.0/22\n - 80.238.180.0/24\n - 80.238.181.0/24\n - 80.238.183.0/24\n - 80.238.184.0/24\n - 80.238.185.0/24\n - 80.238.186.0/24\n - 80.238.190.0/24\n - 80.238.192.0/20\n - 80.238.208.0/20\n - 80.238.224.0/20\n - 80.238.240.0/20\n - 83.101.0.0/21\n - 83.101.104.0/21\n - 83.101.16.0/21\n - 83.101.24.0/21\n - 83.101.32.0/21\n - 83.101.48.0/21\n - 83.101.56.0/23\n - 83.101.58.0/23\n - 83.101.64.0/21\n - 83.101.72.0/21\n - 83.101.8.0/23\n - 83.101.80.0/21\n - 83.101.88.0/24\n - 83.101.89.0/24\n - 83.101.96.0/21\n - 87.119.12.0/24\n - 89.150.192.0/20\n - 89.150.208.0/20\n - 94.244.128.0/20\n - 94.244.144.0/20\n - 94.244.160.0/20\n - 94.244.176.0/20\n - 94.45.160.0/19\n - 94.45.160.0/24\n - 94.45.161.0/24\n - 94.45.163.0/24\n - 94.74.112.0/21\n - 94.74.120.0/21\n - 94.74.64.0/20\n - 94.74.80.0/20\n - 94.74.96.0/20\n"
},
{
"path": "data/crawlers/internet-archive.yaml",
"content": "- name: internet-archive\n action: ALLOW\n # https://ipinfo.io/AS7941\n remote_addresses: [\"207.241.224.0/20\", \"208.70.24.0/21\", \"2620:0:9c0::/48\"]\n"
},
{
"path": "data/crawlers/kagibot.yaml",
"content": "- name: kagibot\n user_agent_regex: \\+https\\://kagi\\.com/bot\n action: ALLOW\n # https://kagi.com/bot\n remote_addresses:\n [\n \"216.18.205.234/32\",\n \"35.212.27.76/32\",\n \"104.254.65.50/32\",\n \"209.151.156.194/32\",\n ]\n"
},
{
"path": "data/crawlers/marginalia.yaml",
"content": "- name: marginalia\n user_agent_regex: search\\.marginalia\\.nu\n action: ALLOW\n # Received directly over email\n remote_addresses:\n [\n \"193.183.0.162/31\",\n \"193.183.0.164/30\",\n \"193.183.0.168/30\",\n \"193.183.0.172/31\",\n \"193.183.0.174/32\",\n ]\n"
},
{
"path": "data/crawlers/mojeekbot.yaml",
"content": "- name: mojeekbot\n user_agent_regex: \\+https\\://www\\.mojeek\\.com/bot\\.html\n action: ALLOW\n # https://www.mojeek.com/bot.html\n remote_addresses: [\"5.102.173.71/32\"]\n"
},
{
"path": "data/crawlers/openai-gptbot.yaml",
"content": "# Collects AI training data\n# https://platform.openai.com/docs/bots/overview-of-openai-crawlers\n- name: openai-gptbot\n user_agent_regex: GPTBot/1\\.1; \\+https\\://openai\\.com/gptbot\n action: ALLOW\n # https://openai.com/gptbot.json\n remote_addresses:\n [\n \"52.230.152.0/24\",\n \"20.171.206.0/24\",\n \"20.171.207.0/24\",\n \"4.227.36.0/25\",\n \"20.125.66.80/28\",\n \"172.182.204.0/24\",\n \"172.182.214.0/24\",\n \"172.182.215.0/24\",\n ]\n"
},
{
"path": "data/crawlers/openai-searchbot.yaml",
"content": "# Indexing for search, does not collect training data\n# https://platform.openai.com/docs/bots/overview-of-openai-crawlers\n- name: openai-searchbot\n user_agent_regex: OAI-SearchBot/1\\.0; \\+https\\://openai\\.com/searchbot\n action: ALLOW\n # https://openai.com/searchbot.json\n remote_addresses:\n [\n \"20.42.10.176/28\",\n \"172.203.190.128/28\",\n \"104.210.140.128/28\",\n \"51.8.102.0/24\",\n \"135.234.64.0/24\",\n ]\n"
},
{
"path": "data/crawlers/perplexitybot.yaml",
"content": "# Indexing for search, does not collect training data\n# https://docs.perplexity.ai/guides/bots\n- name: perplexitybot\n user_agent_regex: PerplexityBot/.+; \\+https\\://perplexity\\.ai/perplexitybot\n action: ALLOW\n # https://www.perplexity.com/perplexitybot.json\n remote_addresses:\n [\n \"107.20.236.150/32\",\n \"3.224.62.45/32\",\n \"18.210.92.235/32\",\n \"3.222.232.239/32\",\n \"3.211.124.183/32\",\n \"3.231.139.107/32\",\n \"18.97.1.228/30\",\n \"18.97.9.96/29\",\n ]\n"
},
{
"path": "data/crawlers/qwantbot.yaml",
"content": "- name: qwantbot\n user_agent_regex: \\+https\\://help\\.qwant\\.com/bot/\n action: ALLOW\n # https://help.qwant.com/wp-content/uploads/sites/2/2025/01/qwantbot.json\n remote_addresses: [\"91.242.162.0/24\"]\n"
},
{
"path": "data/crawlers/tencent-cloud.yaml",
"content": "# Tencent Cloud crawler IP ranges\n- name: tencent-cloud\n action: DENY\n remote_addresses:\n - 101.32.0.0/17\n - 101.32.176.0/20\n - 101.32.192.0/18\n - 101.33.116.0/22\n - 101.33.120.0/21\n - 101.33.16.0/20\n - 101.33.2.0/23\n - 101.33.32.0/19\n - 101.33.4.0/22\n - 101.33.64.0/19\n - 101.33.8.0/21\n - 101.33.96.0/20\n - 119.28.28.0/24\n - 119.29.29.0/24\n - 124.156.0.0/16\n - 129.226.0.0/18\n - 129.226.128.0/18\n - 129.226.224.0/19\n - 129.226.96.0/19\n - 150.109.0.0/18\n - 150.109.128.0/20\n - 150.109.160.0/19\n - 150.109.192.0/18\n - 150.109.64.0/20\n - 150.109.80.0/21\n - 150.109.88.0/22\n - 150.109.96.0/19\n - 162.14.60.0/22\n - 162.62.0.0/18\n - 162.62.128.0/20\n - 162.62.144.0/21\n - 162.62.152.0/22\n - 162.62.172.0/22\n - 162.62.176.0/20\n - 162.62.192.0/19\n - 162.62.255.0/24\n - 162.62.80.0/20\n - 162.62.96.0/19\n - 170.106.0.0/16\n - 43.128.0.0/14\n - 43.132.0.0/22\n - 43.132.12.0/22\n - 43.132.128.0/17\n - 43.132.16.0/22\n - 43.132.28.0/22\n - 43.132.32.0/22\n - 43.132.40.0/22\n - 43.132.52.0/22\n - 43.132.60.0/24\n - 43.132.64.0/22\n - 43.132.69.0/24\n - 43.132.70.0/23\n - 43.132.72.0/21\n - 43.132.80.0/21\n - 43.132.88.0/22\n - 43.132.92.0/23\n - 43.132.96.0/19\n - 43.133.0.0/16\n - 43.134.0.0/16\n - 43.135.0.0/17\n - 43.135.128.0/18\n - 43.135.192.0/19\n - 43.152.0.0/21\n - 43.152.11.0/24\n - 43.152.12.0/22\n - 43.152.128.0/22\n - 43.152.133.0/24\n - 43.152.134.0/23\n - 43.152.136.0/21\n - 43.152.144.0/20\n - 43.152.160.0/22\n - 43.152.16.0/21\n - 43.152.164.0/23\n - 43.152.166.0/24\n - 43.152.168.0/21\n - 43.152.178.0/23\n - 43.152.180.0/22\n - 43.152.184.0/21\n - 43.152.192.0/18\n - 43.152.24.0/22\n - 43.152.31.0/24\n - 43.152.32.0/23\n - 43.152.35.0/24\n - 43.152.36.0/22\n - 43.152.40.0/21\n - 43.152.48.0/20\n - 43.152.74.0/23\n - 43.152.76.0/22\n - 43.152.80.0/22\n - 43.152.8.0/23\n - 43.152.92.0/23\n - 43.153.0.0/16\n - 43.154.0.0/15\n - 43.156.0.0/15\n - 43.158.0.0/16\n - 43.159.0.0/20\n - 43.159.128.0/17\n - 43.159.64.0/23\n - 43.159.70.0/23\n - 43.159.72.0/21\n - 43.159.81.0/24\n - 43.159.82.0/23\n - 43.159.85.0/24\n - 43.159.86.0/23\n - 43.159.88.0/21\n - 43.159.96.0/19\n - 43.160.0.0/15\n - 43.162.0.0/16\n - 43.163.0.0/17\n - 43.163.128.0/18\n - 43.163.192.255/32\n - 43.163.193.0/24\n - 43.163.194.0/23\n - 43.163.196.0/22\n - 43.163.200.0/21\n - 43.163.208.0/20\n - 43.163.224.0/19\n - 43.164.0.0/18\n - 43.164.128.0/17\n - 43.165.0.0/16\n - 43.166.128.0/18\n - 43.166.224.0/19\n - 43.168.0.0/20\n - 43.168.16.0/21\n - 43.168.24.0/22\n - 43.168.255.0/24\n - 43.168.32.0/19\n - 43.168.64.0/20\n - 43.168.80.0/22\n - 43.169.0.0/16\n - 43.170.0.0/16\n - 43.174.0.0/18\n - 43.174.128.0/17\n - 43.174.64.0/22\n - 43.174.68.0/23\n - 43.174.71.0/24\n - 43.174.74.0/23\n - 43.174.76.0/22\n - 43.174.80.0/20\n - 43.174.96.0/19\n - 43.175.0.0/20\n - 43.175.113.0/24\n - 43.175.114.0/23\n - 43.175.116.0/22\n - 43.175.120.0/21\n - 43.175.128.0/18\n - 43.175.16.0/22\n - 43.175.192.0/20\n - 43.175.20.0/23\n - 43.175.208.0/21\n - 43.175.216.0/22\n - 43.175.220.0/23\n - 43.175.22.0/24\n - 43.175.222.0/24\n - 43.175.224.0/20\n - 43.175.25.0/24\n - 43.175.26.0/23\n - 43.175.28.0/22\n - 43.175.32.0/19\n - 43.175.64.0/19\n - 43.175.96.0/20\n"
},
{
"path": "data/crawlers/wikimedia-citoid.yaml",
"content": "# Wikimedia Foundation citation services\n# https://www.mediawiki.org/wiki/Citoid\n\n- name: wikimedia-citoid\n user_agent_regex: \"Citoid/WMF\"\n action: ALLOW\n remote_addresses: [\n \"208.80.152.0/22\",\n \"2620:0:860::/46\",\n ]\n\n- name: wikimedia-zotero-translation-server\n user_agent_regex: \"ZoteroTranslationServer/WMF\"\n action: ALLOW\n remote_addresses: [\n \"208.80.152.0/22\",\n \"2620:0:860::/46\",\n ]"
},
{
"path": "data/crawlers/yandexbot.yaml",
"content": "- name: yandexbot\n action: ALLOW\n expression:\n all:\n - userAgent.matches(\"\\\\+http\\\\://yandex\\\\.com/bots\")\n - verifyFCrDNS(remoteAddress, \"^.*\\\\.yandex\\\\.(ru|com|net)$\")\n"
},
{
"path": "data/embed.go",
"content": "package data\n\nimport \"embed\"\n\nvar (\n\t//go:embed botPolicies.yaml all:apps all:bots all:clients all:common all:crawlers all:meta all:services\n\tBotPolicies embed.FS\n)\n"
},
{
"path": "data/embed_test.go",
"content": "package data\n\nimport (\n\t\"path/filepath\"\n\t\"strings\"\n\t\"testing\"\n)\n\n// TestBotPoliciesEmbed ensures all YAML files in the directory tree\n// are accessible in the embedded BotPolicies filesystem.\nfunc TestBotPoliciesEmbed(t *testing.T) {\n\tyamlFiles, err := filepath.Glob(\"./**/*.yaml\")\n\tif err != nil {\n\t\tt.Fatalf(\"Failed to glob YAML files: %v\", err)\n\t}\n\n\tif len(yamlFiles) == 0 {\n\t\tt.Fatal(\"No YAML files found in directory tree\")\n\t}\n\n\tt.Logf(\"Found %d YAML files to verify\", len(yamlFiles))\n\n\tfor _, filePath := range yamlFiles {\n\t\tembeddedPath := strings.TrimPrefix(filePath, \"./\")\n\n\t\tt.Run(embeddedPath, func(t *testing.T) {\n\t\t\tcontent, err := BotPolicies.ReadFile(embeddedPath)\n\t\t\tif err != nil {\n\t\t\t\tt.Errorf(\"Failed to read %s from embedded filesystem: %v\", embeddedPath, err)\n\t\t\t\treturn\n\t\t\t}\n\n\t\t\tif len(content) == 0 {\n\t\t\t\tt.Errorf(\"File %s exists in embedded filesystem but is empty\", embeddedPath)\n\t\t\t}\n\t\t})\n\t}\n}\n"
},
{
"path": "data/meta/README.md",
"content": "# meta policies\n\nContains policies that exclusively reference policies in _multiple_ other data folders.\n\nAkin to \"stances\" that the administrator can take, with reference to various topics, such as AI/LLM systems.\n"
},
{
"path": "data/meta/ai-block-aggressive.yaml",
"content": "# Blocks all AI/LLM associated user agents, regardless of purpose or human agency\n# Warning: To completely block some AI/LLM training, such as with Google, you _must_ place flags in robots.txt.\n- import: (data)/bots/ai-catchall.yaml\n- import: (data)/clients/ai.yaml\n- import: (data)/crawlers/ai-search.yaml\n- import: (data)/crawlers/ai-training.yaml\n"
},
{
"path": "data/meta/ai-block-moderate.yaml",
"content": "# Blocks all AI/LLM bots used for training or unknown/undocumented purposes.\n# Permits user agents with explicitly documented non-training use, and published IP allowlists.\n- import: (data)/bots/ai-catchall.yaml\n- import: (data)/crawlers/ai-training.yaml\n- import: (data)/crawlers/openai-searchbot.yaml\n- import: (data)/crawlers/perplexitybot.yaml\n- import: (data)/clients/openai-chatgpt-user.yaml\n- import: (data)/clients/mistral-mistralai-user.yaml\n- import: (data)/clients/perplexity-user.yaml\n"
},
{
"path": "data/meta/ai-block-permissive.yaml",
"content": "# Permits all well documented AI/LLM user agents with published IP allowlists.\n- import: (data)/bots/ai-catchall.yaml\n- import: (data)/crawlers/openai-searchbot.yaml\n- import: (data)/crawlers/openai-gptbot.yaml\n- import: (data)/crawlers/perplexitybot.yaml\n- import: (data)/clients/openai-chatgpt-user.yaml\n- import: (data)/clients/mistral-mistralai-user.yaml\n- import: (data)/clients/perplexity-user.yaml\n"
},
{
"path": "data/meta/default-config.yaml",
"content": "- # Pathological bots to deny\n # This correlates to data/bots/_deny-pathological.yaml in the source tree\n # https://github.com/TecharoHQ/anubis/blob/main/data/bots/_deny-pathological.yaml\n import: (data)/bots/_deny-pathological.yaml\n- import: (data)/bots/aggressive-brazilian-scrapers.yaml\n\n# Aggressively block AI/LLM related bots/agents by default\n- import: (data)/meta/ai-block-aggressive.yaml\n\n# Consider replacing the aggressive AI policy with more selective policies:\n# - import: (data)/meta/ai-block-moderate.yaml\n# - import: (data)/meta/ai-block-permissive.yaml\n\n# Search engine crawlers to allow, defaults to:\n# - Google (so they don't try to bypass Anubis)\n# - Apple\n# - Bing\n# - DuckDuckGo\n# - Qwant\n# - The Internet Archive\n# - Kagi\n# - Marginalia\n# - Mojeek\n- import: (data)/crawlers/_allow-good.yaml\n# Challenge Firefox AI previews\n- import: (data)/clients/x-firefox-ai.yaml\n\n# Allow common \"keeping the internet working\" routes (well-known, favicon, robots.txt)\n- import: (data)/common/keep-internet-working.yaml\n\n# # Punish any bot with \"bot\" in the user-agent string\n# # This is known to have a high false-positive rate, use at your own risk\n# - name: generic-bot-catchall\n# user_agent_regex: (?i:bot|crawler)\n# action: CHALLENGE\n# challenge:\n# difficulty: 16 # impossible\n# algorithm: slow # intentionally waste CPU cycles and time\n\n# Requires a subscription to Thoth to use, see\n# https://anubis.techaro.lol/docs/admin/thoth#geoip-based-filtering\n- name: countries-with-aggressive-scrapers\n action: WEIGH\n geoip:\n countries:\n - BR\n - CN\n weight:\n adjust: 10\n\n# Requires a subscription to Thoth to use, see\n# https://anubis.techaro.lol/docs/admin/thoth#asn-based-filtering\n- name: aggressive-asns-without-functional-abuse-contact\n action: WEIGH\n asns:\n match:\n - 13335 # Cloudflare\n - 136907 # Huawei Cloud\n - 45102 # Alibaba Cloud\n weight:\n adjust: 10\n\n# ## System load based checks.\n# # If the system is under high load, add weight.\n# - name: high-load-average\n# action: WEIGH\n# expression: load_1m >= 10.0 # make sure to end the load comparison in a .0\n# weight:\n# adjust: 20\n\n## If your backend service is running on the same operating system as Anubis,\n## you can uncomment this rule to make the challenge easier when the system is\n## under low load.\n##\n## If it is not, remove weight.\n# - name: low-load-average\n# action: WEIGH\n# expression: load_15m <= 4.0 # make sure to end the load comparison in a .0\n# weight:\n# adjust: -10\n\n# Generic catchall rule\n- name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: WEIGH\n weight:\n adjust: 10\n"
},
{
"path": "data/meta/messengers-preview.yaml",
"content": "- import: (data)/clients/telegram-preview.yaml\n- import: (data)/clients/vk-preview.yaml\n"
},
{
"path": "data/services/updown.yaml",
"content": "# https://updown.io/about\n- name: updown\n user_agent_regex: updown.io\n action: ALLOW\n remote_addresses: [\n \"45.32.74.41/32\",\n \"104.238.136.194/32\",\n \"192.99.37.47/32\",\n \"91.121.222.175/32\",\n \"104.238.159.87/32\",\n \"102.212.60.78/32\",\n \"135.181.102.135/32\",\n \"45.32.107.181/32\",\n \"45.76.104.117/32\",\n \"45.63.29.207/32\",\n \"2001:19f0:6001:2c6::1/128\",\n \"2001:19f0:9002:11a::1/128\",\n \"2607:5300:60:4c2f::1/128\",\n \"2001:41d0:2:85af::1/128\",\n \"2001:19f0:6c01:145::1/128\",\n \"2c0f:c40:4003:4::2/128\",\n \"2a01:4f9:c010:d5f9::1/128\",\n \"2001:19f0:4400:402e::1/128\",\n \"2001:19f0:7001:45a::1/128\",\n \"2001:19f0:5801:1d8::1/128\"\n ]"
},
{
"path": "data/services/uptime-robot.yaml",
"content": "- name: uptime-robot\n user_agent_regex: UptimeRobot\n action: ALLOW\n # https://api.uptimerobot.com/meta/ips\n remote_addresses:\n [\n \"3.12.251.153/32\",\n \"3.20.63.178/32\",\n \"3.77.67.4/32\",\n \"3.79.134.69/32\",\n \"3.105.133.239/32\",\n \"3.105.190.221/32\",\n \"3.133.226.214/32\",\n \"3.149.57.90/32\",\n \"3.212.128.62/32\",\n \"5.161.61.238/32\",\n \"5.161.73.160/32\",\n \"5.161.75.7/32\",\n \"5.161.113.195/32\",\n \"5.161.117.52/32\",\n \"5.161.177.47/32\",\n \"5.161.194.92/32\",\n \"5.161.215.244/32\",\n \"5.223.43.32/32\",\n \"5.223.53.147/32\",\n \"5.223.57.22/32\",\n \"18.116.205.62/32\",\n \"18.180.208.214/32\",\n \"18.192.166.72/32\",\n \"18.193.252.127/32\",\n \"24.144.78.39/32\",\n \"24.144.78.185/32\",\n \"34.198.201.66/32\",\n \"45.55.123.175/32\",\n \"45.55.127.146/32\",\n \"49.13.24.81/32\",\n \"49.13.130.29/32\",\n \"49.13.134.145/32\",\n \"49.13.164.148/32\",\n \"49.13.167.123/32\",\n \"52.15.147.27/32\",\n \"52.22.236.30/32\",\n \"52.28.162.93/32\",\n \"52.59.43.236/32\",\n \"52.87.72.16/32\",\n \"54.64.67.106/32\",\n \"54.79.28.129/32\",\n \"54.87.112.51/32\",\n \"54.167.223.174/32\",\n \"54.249.170.27/32\",\n \"63.178.84.147/32\",\n \"64.225.81.248/32\",\n \"64.225.82.147/32\",\n \"69.162.124.227/32\",\n \"69.162.124.235/32\",\n \"69.162.124.238/32\",\n \"78.46.190.63/32\",\n \"78.46.215.1/32\",\n \"78.47.98.55/32\",\n \"78.47.173.76/32\",\n \"88.99.80.227/32\",\n \"91.99.101.207/32\",\n \"128.140.41.193/32\",\n \"128.140.106.114/32\",\n \"129.212.132.140/32\",\n \"134.199.240.137/32\",\n \"138.197.53.117/32\",\n \"138.197.53.138/32\",\n \"138.197.54.143/32\",\n \"138.197.54.247/32\",\n \"138.197.63.92/32\",\n \"139.59.50.44/32\",\n \"142.132.180.39/32\",\n \"143.198.249.237/32\",\n \"143.198.250.89/32\",\n \"143.244.196.21/32\",\n \"143.244.196.211/32\",\n \"143.244.221.177/32\",\n \"144.126.251.21/32\",\n \"146.190.9.187/32\",\n \"152.42.149.135/32\",\n \"157.90.155.240/32\",\n \"157.90.156.63/32\",\n \"159.69.158.189/32\",\n \"159.223.243.219/32\",\n \"161.35.247.201/32\",\n \"167.99.18.52/32\",\n \"167.235.143.113/32\",\n \"168.119.53.160/32\",\n \"168.119.96.239/32\",\n \"168.119.123.75/32\",\n \"170.64.250.64/32\",\n \"170.64.250.132/32\",\n \"170.64.250.235/32\",\n \"178.156.181.172/32\",\n \"178.156.184.20/32\",\n \"178.156.185.127/32\",\n \"178.156.185.231/32\",\n \"178.156.187.238/32\",\n \"178.156.189.113/32\",\n \"178.156.189.249/32\",\n \"188.166.201.79/32\",\n \"206.189.241.133/32\",\n \"209.38.49.1/32\",\n \"209.38.49.206/32\",\n \"209.38.49.226/32\",\n \"209.38.51.43/32\",\n \"209.38.53.7/32\",\n \"209.38.124.252/32\",\n \"216.144.248.18/31\",\n \"216.144.248.21/32\",\n \"216.144.248.22/31\",\n \"216.144.248.24/30\",\n \"216.144.248.28/31\",\n \"216.144.248.30/32\",\n \"216.245.221.83/32\",\n \"2400:6180:10:200::56a0:b000/128\",\n \"2400:6180:10:200::56a0:c000/128\",\n \"2400:6180:10:200::56a0:e000/128\",\n \"2400:6180:100:d0::94b6:4001/128\",\n \"2400:6180:100:d0::94b6:5001/128\",\n \"2400:6180:100:d0::94b6:7001/128\",\n \"2406:da14:94d:8601:9d0d:7754:bedf:e4f5/128\",\n \"2406:da14:94d:8601:b325:ff58:2bba:7934/128\",\n \"2406:da14:94d:8601:db4b:c5ac:2cbe:9a79/128\",\n \"2406:da1c:9c8:dc02:7ae1:f2ea:ab91:2fde/128\",\n \"2406:da1c:9c8:dc02:7db9:f38b:7b9f:402e/128\",\n \"2406:da1c:9c8:dc02:82b2:f0fd:ee96:579/128\",\n \"2600:1f16:775:3a00:ac3:c5eb:7081:942e/128\",\n \"2600:1f16:775:3a00:37bf:6026:e54a:f03a/128\",\n \"2600:1f16:775:3a00:3f24:5bb0:95d7:5a6b/128\",\n \"2600:1f16:775:3a00:8c2c:2ba6:778f:5be5/128\",\n \"2600:1f16:775:3a00:91ac:3120:ff38:92b5/128\",\n \"2600:1f16:775:3a00:dbbe:36b0:3c45:da32/128\",\n \"2600:1f18:179:f900:71:af9a:ade7:d772/128\",\n \"2600:1f18:179:f900:2406:9399:4ae6:c5d3/128\",\n \"2600:1f18:179:f900:4696:7729:7bb3:f52f/128\",\n \"2600:1f18:179:f900:4b7d:d1cc:2d10:211/128\",\n \"2600:1f18:179:f900:5c68:91b6:5d75:5d7/128\",\n \"2600:1f18:179:f900:e8dd:eed1:a6c:183b/128\",\n \"2604:a880:800:14:0:1:68ba:d000/128\",\n \"2604:a880:800:14:0:1:68ba:e000/128\",\n \"2604:a880:800:14:0:1:68bb:0/128\",\n \"2604:a880:800:14:0:1:68bb:1000/128\",\n \"2604:a880:800:14:0:1:68bb:3000/128\",\n \"2604:a880:800:14:0:1:68bb:4000/128\",\n \"2604:a880:800:14:0:1:68bb:5000/128\",\n \"2604:a880:800:14:0:1:68bb:6000/128\",\n \"2604:a880:800:14:0:1:68bb:7000/128\",\n \"2604:a880:800:14:0:1:68bb:a000/128\",\n \"2604:a880:800:14:0:1:68bb:b000/128\",\n \"2604:a880:800:14:0:1:68bb:c000/128\",\n \"2604:a880:800:14:0:1:68bb:d000/128\",\n \"2604:a880:800:14:0:1:68bb:e000/128\",\n \"2604:a880:800:14:0:1:68bb:f000/128\",\n \"2607:ff68:107::4/128\",\n \"2607:ff68:107::14/128\",\n \"2607:ff68:107::33/128\",\n \"2607:ff68:107::48/127\",\n \"2607:ff68:107::50/125\",\n \"2607:ff68:107::58/127\",\n \"2607:ff68:107::60/128\",\n \"2a01:4f8:c0c:83fa::1/128\",\n \"2a01:4f8:c17:42e4::1/128\",\n \"2a01:4f8:c2c:9fc6::1/128\",\n \"2a01:4f8:c2c:beae::1/128\",\n \"2a01:4f8:1c1a:3d53::1/128\",\n \"2a01:4f8:1c1b:4ef4::1/128\",\n \"2a01:4f8:1c1b:5b5a::1/128\",\n \"2a01:4f8:1c1b:7ecc::1/128\",\n \"2a01:4f8:1c1c:11aa::1/128\",\n \"2a01:4f8:1c1c:5353::1/128\",\n \"2a01:4f8:1c1c:7240::1/128\",\n \"2a01:4f8:1c1c:a98a::1/128\",\n \"2a01:4f8:c012:c60e::1/128\",\n \"2a01:4f8:c013:c18::1/128\",\n \"2a01:4f8:c013:34c0::1/128\",\n \"2a01:4f8:c013:3b0f::1/128\",\n \"2a01:4f8:c013:3c52::1/128\",\n \"2a01:4f8:c013:3c53::1/128\",\n \"2a01:4f8:c013:3c54::1/128\",\n \"2a01:4f8:c013:3c55::1/128\",\n \"2a01:4f8:c013:3c56::1/128\",\n \"2a01:4ff:f0:bfd::1/128\",\n \"2a01:4ff:f0:2219::1/128\",\n \"2a01:4ff:f0:3e03::1/128\",\n \"2a01:4ff:f0:5f80::1/128\",\n \"2a01:4ff:f0:7fad::1/128\",\n \"2a01:4ff:f0:9c5f::1/128\",\n \"2a01:4ff:f0:b2f2::1/128\",\n \"2a01:4ff:f0:b6f1::1/128\",\n \"2a01:4ff:f0:d283::1/128\",\n \"2a01:4ff:f0:d3cd::1/128\",\n \"2a01:4ff:f0:e516::1/128\",\n \"2a01:4ff:f0:e9cf::1/128\",\n \"2a01:4ff:f0:eccb::1/128\",\n \"2a01:4ff:f0:efd1::1/128\",\n \"2a01:4ff:f0:fdc7::1/128\",\n \"2a01:4ff:2f0:193c::1/128\",\n \"2a01:4ff:2f0:27de::1/128\",\n \"2a01:4ff:2f0:3b3a::1/128\",\n \"2a03:b0c0:2:f0::bd91:f001/128\",\n \"2a03:b0c0:2:f0::bd92:1/128\",\n \"2a03:b0c0:2:f0::bd92:1001/128\",\n \"2a03:b0c0:2:f0::bd92:2001/128\",\n \"2a03:b0c0:2:f0::bd92:4001/128\",\n \"2a03:b0c0:2:f0::bd92:5001/128\",\n \"2a03:b0c0:2:f0::bd92:6001/128\",\n \"2a03:b0c0:2:f0::bd92:7001/128\",\n \"2a03:b0c0:2:f0::bd92:8001/128\",\n \"2a03:b0c0:2:f0::bd92:9001/128\",\n \"2a03:b0c0:2:f0::bd92:a001/128\",\n \"2a03:b0c0:2:f0::bd92:b001/128\",\n \"2a03:b0c0:2:f0::bd92:c001/128\",\n \"2a03:b0c0:2:f0::bd92:e001/128\",\n \"2a03:b0c0:2:f0::bd92:f001/128\",\n \"2a05:d014:1815:3400:6d:9235:c1c0:96ad/128\",\n \"2a05:d014:1815:3400:654f:bd37:724c:212b/128\",\n \"2a05:d014:1815:3400:90b4:4ef9:5631:b170/128\",\n \"2a05:d014:1815:3400:9779:d8e9:100a:9642/128\",\n \"2a05:d014:1815:3400:af29:e95e:64ff:df81/128\",\n \"2a05:d014:1815:3400:c7d6:f7f3:6cc1:30d1/128\",\n \"2a05:d014:1815:3400:d784:e5dd:8e0:67cb/128\",\n ]\n"
},
{
"path": "decaymap/decaymap.go",
"content": "package decaymap\n\nimport (\n\t\"sync\"\n\t\"time\"\n)\n\nfunc Zilch[T any]() T {\n\tvar zero T\n\treturn zero\n}\n\n// Impl is a lazy key->value map. It's a wrapper around a map and a mutex. If values exceed their time-to-live, they are pruned at Get time.\ntype Impl[K comparable, V any] struct {\n\tdata map[K]decayMapEntry[V]\n\n\t// deleteCh receives decay-deletion requests from readers.\n\tdeleteCh chan deleteReq[K]\n\t// stopCh stops the background cleanup worker.\n\tstopCh chan struct{}\n\twg sync.WaitGroup\n\tlock sync.RWMutex\n}\n\ntype decayMapEntry[V any] struct {\n\tValue V\n\texpiry time.Time\n}\n\n// deleteReq is a request to remove a key if its expiry timestamp still matches\n// the observed one. This prevents racing with concurrent Set updates.\ntype deleteReq[K comparable] struct {\n\tkey K\n\texpiry time.Time\n}\n\n// New creates a new DecayMap of key type K and value type V.\n//\n// Key types must be comparable to work with maps.\nfunc New[K comparable, V any]() *Impl[K, V] {\n\tm := &Impl[K, V]{\n\t\tdata: make(map[K]decayMapEntry[V]),\n\t\tdeleteCh: make(chan deleteReq[K], 1024),\n\t\tstopCh: make(chan struct{}),\n\t}\n\tm.wg.Add(1)\n\tgo m.cleanupWorker()\n\treturn m\n}\n\n// expire forcibly expires a key by setting its time-to-live one second in the past.\nfunc (m *Impl[K, V]) expire(key K) bool {\n\t// Use a single write lock to avoid RUnlock->Lock convoy.\n\tm.lock.Lock()\n\tdefer m.lock.Unlock()\n\tval, ok := m.data[key]\n\tif !ok {\n\t\treturn false\n\t}\n\tval.expiry = time.Now().Add(-1 * time.Second)\n\tm.data[key] = val\n\treturn true\n}\n\n// Delete a value from the DecayMap by key.\n//\n// If the value does not exist, return false. Return true after\n// deletion.\nfunc (m *Impl[K, V]) Delete(key K) bool {\n\t// Use a single write lock to avoid RUnlock->Lock convoy.\n\tm.lock.Lock()\n\tdefer m.lock.Unlock()\n\t_, ok := m.data[key]\n\tif ok {\n\t\tdelete(m.data, key)\n\t}\n\treturn ok\n}\n\n// Get gets a value from the DecayMap by key.\n//\n// If a value has expired, forcibly delete it if it was not updated.\nfunc (m *Impl[K, V]) Get(key K) (V, bool) {\n\tm.lock.RLock()\n\tvalue, ok := m.data[key]\n\tm.lock.RUnlock()\n\n\tif !ok {\n\t\treturn Zilch[V](), false\n\t}\n\n\tif time.Now().After(value.expiry) {\n\t\t// Defer decay deletion to the background worker to avoid convoy.\n\t\tselect {\n\t\tcase m.deleteCh <- deleteReq[K]{key: key, expiry: value.expiry}:\n\t\tdefault:\n\t\t\t// Channel full: drop request; a future Cleanup() or Get will retry.\n\t\t}\n\n\t\treturn Zilch[V](), false\n\t}\n\n\treturn value.Value, true\n}\n\n// Set sets a key value pair in the map.\nfunc (m *Impl[K, V]) Set(key K, value V, ttl time.Duration) {\n\tm.lock.Lock()\n\tdefer m.lock.Unlock()\n\n\tm.data[key] = decayMapEntry[V]{\n\t\tValue: value,\n\t\texpiry: time.Now().Add(ttl),\n\t}\n}\n\n// Cleanup removes all expired entries from the DecayMap.\nfunc (m *Impl[K, V]) Cleanup() {\n\tm.lock.Lock()\n\tdefer m.lock.Unlock()\n\n\tnow := time.Now()\n\tfor key, entry := range m.data {\n\t\tif now.After(entry.expiry) {\n\t\t\tdelete(m.data, key)\n\t\t}\n\t}\n}\n\n// Len returns the number of entries in the DecayMap.\nfunc (m *Impl[K, V]) Len() int {\n\tm.lock.RLock()\n\tdefer m.lock.RUnlock()\n\treturn len(m.data)\n}\n\n// Close stops the background cleanup worker. It's optional to call; maps live\n// for the process lifetime in many cases. Call in tests or when you know you no\n// longer need the map to avoid goroutine leaks.\nfunc (m *Impl[K, V]) Close() {\n\tclose(m.stopCh)\n\tm.wg.Wait()\n}\n\n// cleanupWorker batches decay deletions to minimize lock contention.\nfunc (m *Impl[K, V]) cleanupWorker() {\n\tdefer m.wg.Done()\n\tbatch := make([]deleteReq[K], 0, 64)\n\tticker := time.NewTicker(500 * time.Millisecond)\n\tdefer ticker.Stop()\n\n\tflush := func() {\n\t\tif len(batch) == 0 {\n\t\t\treturn\n\t\t}\n\t\tm.applyDeletes(batch)\n\t\t// reset batch without reallocating\n\t\tbatch = batch[:0]\n\t}\n\n\tfor {\n\t\tselect {\n\t\tcase req := <-m.deleteCh:\n\t\t\tbatch = append(batch, req)\n\t\tcase <-ticker.C:\n\t\t\tflush()\n\t\tcase <-m.stopCh:\n\t\t\t// Drain any remaining requests then exit\n\t\t\tfor {\n\t\t\t\tselect {\n\t\t\t\tcase req := <-m.deleteCh:\n\t\t\t\t\tbatch = append(batch, req)\n\t\t\t\tdefault:\n\t\t\t\t\tflush()\n\t\t\t\t\treturn\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n}\n\nfunc (m *Impl[K, V]) applyDeletes(batch []deleteReq[K]) {\n\tnow := time.Now()\n\tm.lock.Lock()\n\tfor _, req := range batch {\n\t\tentry, ok := m.data[req.key]\n\t\tif !ok {\n\t\t\tcontinue\n\t\t}\n\t\t// Only delete if the expiry is unchanged and already past.\n\t\tif entry.expiry.Equal(req.expiry) && now.After(entry.expiry) {\n\t\t\tdelete(m.data, req.key)\n\t\t}\n\t}\n\tm.lock.Unlock()\n}\n"
},
{
"path": "decaymap/decaymap_test.go",
"content": "package decaymap\n\nimport (\n\t\"testing\"\n\t\"time\"\n)\n\nfunc TestImpl(t *testing.T) {\n\tdm := New[string, string]()\n\tt.Cleanup(dm.Close)\n\n\tdm.Set(\"test\", \"hi\", 5*time.Minute)\n\n\tval, ok := dm.Get(\"test\")\n\tif !ok {\n\t\tt.Error(\"somehow the test key was not set\")\n\t}\n\n\tif val != \"hi\" {\n\t\tt.Errorf(\"wanted value %q, got: %q\", \"hi\", val)\n\t}\n\n\tok = dm.expire(\"test\")\n\tif !ok {\n\t\tt.Error(\"somehow could not force-expire the test key\")\n\t}\n\n\t_, ok = dm.Get(\"test\")\n\tif ok {\n\t\tt.Error(\"got value even though it was supposed to be expired\")\n\t}\n\n\t// Deletion of expired entries after Get is deferred to a background worker.\n\t// Assert it eventually disappears from the map.\n\tdeadline := time.Now().Add(700 * time.Millisecond)\n\tfor time.Now().Before(deadline) {\n\t\tif dm.Len() == 0 {\n\t\t\tbreak\n\t\t}\n\t\ttime.Sleep(5 * time.Millisecond)\n\t}\n\tif dm.Len() != 0 {\n\t\tt.Fatalf(\"expected background cleanup to remove expired key; len=%d\", dm.Len())\n\t}\n}\n\nfunc TestCleanup(t *testing.T) {\n\tdm := New[string, string]()\n\tt.Cleanup(dm.Close)\n\n\tdm.Set(\"test1\", \"hi1\", 1*time.Second)\n\tdm.Set(\"test2\", \"hi2\", 2*time.Second)\n\tdm.Set(\"test3\", \"hi3\", 3*time.Second)\n\n\tdm.expire(\"test1\") // Force expire test1\n\tdm.expire(\"test2\") // Force expire test2\n\n\tdm.Cleanup()\n\n\tfinalLen := dm.Len() // Get the length after cleanup\n\n\tif finalLen != 1 { // \"test3\" should be the only one left\n\t\tt.Errorf(\"Cleanup failed to remove expired entries. Expected length 1, got %d\", finalLen)\n\t}\n\n\tif _, ok := dm.Get(\"test1\"); ok { // Verify Get still behaves correctly after Cleanup\n\t\tt.Error(\"test1 should not be found after cleanup\")\n\t}\n\tif _, ok := dm.Get(\"test2\"); ok {\n\t\tt.Error(\"test2 should not be found after cleanup\")\n\t}\n\tif val, ok := dm.Get(\"test3\"); !ok || val != \"hi3\" {\n\t\tt.Error(\"test3 should still be found after cleanup\")\n\t}\n}\n"
},
{
"path": "docs/.dockerignore",
"content": "# Dependencies\n/node_modules\n\n# Production\n/build\n\n# Generated files\n.docusaurus\n.cache-loader\n\n# Misc\n.DS_Store\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n\n"
},
{
"path": "docs/.gitignore",
"content": "# Dependencies\n/node_modules\n\n# Production\n/build\n\n# Generated files\n.docusaurus\n.cache-loader\n\n# Misc\n.DS_Store\n.env.local\n.env.development.local\n.env.test.local\n.env.production.local\n\nnpm-debug.log*\nyarn-debug.log*\nyarn-error.log*\n"
},
{
"path": "docs/Dockerfile",
"content": "FROM docker.io/library/node:lts AS build\n\nWORKDIR /app\nCOPY . .\n\nRUN npm ci && npm run build\n\nFROM ghcr.io/xe/nginx-micro\nCOPY --from=build /app/build /www\nCOPY ./manifest/cfg/nginx/nginx.conf /conf\nLABEL org.opencontainers.image.source=\"https://github.com/TecharoHQ/anubis\""
},
{
"path": "docs/README.md",
"content": "# Website\n\nThis website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.\n\n### Installation\n\n```\n$ yarn\n```\n\n### Local Development\n\n```\n$ yarn start\n```\n\nThis command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.\n\n### Build\n\n```\n$ yarn build\n```\n\nThis command generates static content into the `build` directory and can be served using any static contents hosting service.\n\n### Deployment\n\nUsing SSH:\n\n```\n$ USE_SSH=true yarn deploy\n```\n\nNot using SSH:\n\n```\n$ GIT_USER=<Your GitHub username> yarn deploy\n```\n\nIf you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.\n"
},
{
"path": "docs/blog/2025-06-16-welcome/index.mdx",
"content": "---\nslug: welcome\ntitle: Welcome to the Anubis blog!\nauthors: [xe]\ntags: [intro]\n---\n\nHello, world!\n\nAt Techaro, we've been working on making Anubis even better, and in the process we want to share what we've done, how it works, and signal boost cool things the community has done. As things happen, we'll blog about them so that you can learn from our struggles.\n\nMore details to come soon!\n\n{/* truncate */}\n"
},
{
"path": "docs/blog/2025-06-27-release-1.20.0/index.mdx",
"content": "---\nslug: release/v1.20.0\ntitle: Anubis v1.20.0 is now available!\nauthors: [xe]\ntags: [release]\nimage: sunburst.webp\n---\n\n\n\nHey all!\n\nToday we released [Anubis v1.20.0: Thancred Waters](https://github.com/TecharoHQ/anubis/releases/tag/v1.20.0). This adds a lot of new and exciting features to Anubis, including but not limited to the `WEIGH` action, custom weight thresholds, Imprint/impressum support, and a no-JS challenge. Here's what you need to know so you can protect your websites in new and exciting ways!\n\n{/* truncate */}\n\n## Sponsoring the product\n\nIf you rely on Anubis to keep your website safe, please consider sponsoring the project on [GitHub Sponsors](https://github.com/sponsors/Xe) or [Patreon](https://patreon.com/cadey). Funding helps pay hosting bills and offset the time spent on making this project the best it can be. Every little bit helps and when enough money is raised, [I can make Anubis my full-time job](https://github.com/TecharoHQ/anubis/discussions/278).\n\nI am waiting to hear back from NLNet on if Anubis was selected for funding or not. Let's hope it is!\n\n## Deprecation warning: `DIFFICULTY`\n\nAnubis v1.20.0 is the last version to support the `DIFFICULTY` flag in the exact way it currently does. In future versions, this will be ineffectual and you should use the [custom threshold system](/docs/admin/configuration/thresholds) instead.\n\nIf this becomes an imposition in practice, this will be reverted.\n\n## Chrome won't show \"invalid response\" after \"Success!\"\n\nThere were a bunch of smaller fixes in Anubis this time around, but the biggest one was finally squashing the [\"invalid response\" after \"Success!\" issue](https://github.com/TecharoHQ/anubis/issues/564) that had been plaguing Chrome users. This was a really annoying issue to track down but it was discovered while we were working on better end-to-end / functional testing: [Chrome randomizes the `Accept-Language` header](https://github.com/explainers-by-googlers/reduce-accept-language) so that websites can't do fingerprinting as easily.\n\nWhen Anubis issues a challenge, it grabs [information that the browser sends to the user](/docs/design/how-anubis-works#challenge-format) to create a challenge string. Anubis doesn't store these challenge strings anywhere, and when a solution is being checked it calculates the challenge string from the request. This means that they'd get a challenge on one end, compute the response for that challenge, and then the server would validate that against a different challenge. This server-side validation would fail, leading to the user seeing \"invalid response\" after the client reported success.\n\nI suspect this was why Vanadium and Cromite were having sporadic issues as well.\n\n## New Features\n\nThe biggest feature in Anubis is the \"weight\" subsystem. This allows administrators to make custom rules that change the suspicion level of a request without having to take immediate action. As an example, consider the self-hostable git forge [Gitea](https://about.gitea.com/). When you load a page in Gitea, it creates a session cookie that your browser sends with every request. Weight allows you to mark a request that includes a Gitea session token as _less_ suspicious:\n\n```yaml\n- name: gitea-session-token\n action: WEIGH\n expression:\n all:\n # Check if the request has a Cookie header\n - '\"Cookie\" in headers'\n # Check if the request's Cookie header contains the Gitea session token\n - headers[\"Cookie\"].contains(\"i_love_gitea=\")\n # Remove 5 weight points\n weight:\n adjust: -5\n```\n\nThis is different from the past where you could only allow every request with a Gitea session token, meaning that the invention of lying would allow malicious clients to bypass protection.\n\nWeight is added and removed whenever a `WEIGH` rule is encountered. When all rules are processed and the request doesn't match any `ALLOW`, `CHALLENGE`, or `DENY` rules, Anubis uses [weight thresholds](/docs/admin/configuration/thresholds) to figure out how to handle that request. Thresholds are defined in the [policy file](/docs/admin/policies) alongside your bot rules:\n\n```yaml\nthresholds:\n - name: minimal-suspicion # This client is likely fine, its soul is lighter than a feather\n expression: weight <= 0 # a feather weighs zero units\n action: ALLOW # Allow the traffic through\n # For clients that had some weight reduced through custom rules, give them a\n # lightweight challenge.\n - name: mild-suspicion\n expression:\n all:\n - weight > 0\n - weight < 10\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/metarefresh\n algorithm: metarefresh\n difficulty: 1\n report_as: 1\n # For clients that are browser-like but have either gained points from custom rules or\n # report as a standard browser.\n - name: moderate-suspicion\n expression:\n all:\n - weight >= 10\n - weight < 20\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 2 # two leading zeros, very fast for most clients\n report_as: 2\n # For clients that are browser like and have gained many points from custom rules\n - name: extreme-suspicion\n expression: weight >= 20\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 4\n report_as: 4\n```\n\n:::note\n\nIf you don't have thresholds defined in your Anubis policy file, Anubis will default to the \"legacy\" behaviour where browser-like clients get a challenge at the default difficulty.\n\n:::\n\nThis lets most clients through if they pass a simple [proof of work challenge](/docs/admin/configuration/challenges/proof-of-work), but any clients that are less suspicious (like ones with a Gitea session token) are given the lightweight [Meta Refresh](/docs/admin/configuration/challenges/metarefresh) challenge instead.\n\nThreshold expressions are like [Bot rule expressions](/docs/admin/configuration/expressions), but there's only one input: the request's weight. If no thresholds match, the request is allowed through.\n\n### Imprint/Impressum Support\n\nEuropean countries like Germany [require an imprint/impressum](https://www.ionos.com/digitalguide/websites/digital-law/a-case-for-thinking-global-germanys-impressum-laws/) to be present in the footer of their website. This allows users to contact someone on the team behind a website in case they run into issues. This also must generally have a separate page where users can view an extended imprint with other information like a privacy policy or a copyright notice.\n\nAnubis v1.20.0 and later [has support for showing imprints](/docs/admin/configuration/impressum). You can configure two kinds of imprints:\n\n1. An imprint that is shown in the footer of every Anubis page.\n2. An extended imprint / privacy policy that is shown when users click on the \"Imprint\" link. For example, [here's the imprint for the website you're looking at right now](https://anubis.techaro.lol/.within.website/x/cmd/anubis/api/imprint).\n\nImprints are configured in [the policy file](/docs/admin/policies/):\n\n```yaml\nimpressum:\n # Displayed at the bottom of every page rendered by Anubis.\n footer: >-\n This website is hosted by Zombocom. If you have any complaints or notes \n about the service, please contact\n <a href=\"mailto:contact@zombocom.example\">contact@zombocom.example</a> and\n we will assist you as soon as possible.\n\n # The imprint page that will be linked to at the footer of every Anubis page.\n page:\n # The HTML <title> of the page\n title: Imprint and Privacy Policy\n # The HTML contents of the page. The exact contents of this page can\n # and will vary by locale. Please consult with a lawyer if you are not\n # sure what to put here.\n body: >-\n <p>Last updated: June 2025</p>\n\n <h2>Information that is gathered from visitors</h2>\n\n <p>In common with other websites, log files are stored on the web server\n saving details such as the visitor's IP address, browser type, referring\n page and time of visit.</p>\n\n <p>Cookies may be used to remember visitor preferences when interacting\n with the website.</p>\n\n <p>Where registration is required, the visitor's email and a username\n will be stored on the server.</p>\n\n <!-- ... -->\n```\n\nIf this is insufficient, please [file an issue](https://github.com/TecharoHQ/anubis/issues/new) with a link to the relevant legislation for your country so that this feature can be amended and improved.\n\n### No-JS Challenge\n\nOne of the first issues in Anubis before it was moved to the [TecharoHQ org](https://github.com/TecharoHQ) was a request [to support challenging browsers without using JavaScript](https://github.com/Xe/x/issues/651). This is a pretty challenging thing to do without rethinking how Anubis works from a fundamentally low level, and with v1.20.0, [Anubis finally has support for running without client-side JavaScript](https://github.com/TecharoHQ/anubis/issues/95) thanks to the [Meta Refresh](/docs/admin/configuration/challenges/metarefresh) challenge.\n\nWhen Anubis decides it needs to send a challenge to your browser, it sends a challenge page. Historically, this challenge page is [an HTML template](https://github.com/TecharoHQ/anubis/blob/main/web/index.templ) that kicks off some JavaScript, reads the challenge information out of the page body, and then solves it as fast as possible in order to let users see the website they want to visit.\n\nIn v1.20.0, Anubis has a challenge registry to hold [different client challenge implementations](/docs/admin/configuration/challenges/). This allows us to implement anything we want as long as it can render a page to show a challenge and then check if the result is correct. This is going to be used to implement a WebAssembly-based proof of work option (one that will be way more efficient than the existing browser JS version), but as a proof of concept I implemented a simple challenge using [HTML `<meta refresh>`](https://en.wikipedia.org/wiki/Meta_refresh).\n\nIn my testing, this has worked with every browser I have thrown it at (including CLI browsers, the browser embedded in emacs, etc.). The default configuration of Anubis does use the [meta refresh challenge](/docs/admin/configuration/challenges/metarefresh) for [clients with a very low suspicion](/docs/admin/configuration/thresholds), but by default clients will be sent an [easy proof of work challenge](/docs/admin/configuration/challenges/proof-of-work).\n\nIf the false positive rate of this challenge turns out to not be very high in practice, the meta refresh challenge will be enabled by default for browsers in future versions of Anubis.\n\n### `robots2policy`\n\nAnubis was created because crawler bots don't respect [`robots.txt` files](https://www.robotstxt.org/). Administrators have been working on refining and crafting their `robots.txt` files for years, and one common comment is that people don't know where to start crafting their own rules.\n\nAnubis now ships with a [`robots2policy` tool](/docs/admin/robots2policy) that lets you convert your `robots.txt` file to an Anubis policy.\n\n```text\nrobots2policy -input https://github.com/robots.txt\n```\n\n:::note\n\nIf you installed Anubis from [an OS package](/docs/admin/native-install), you may need to run `anubis-robots2policy` instead of `robots2policy`.\n\n:::\n\nWe hope that this will help you get started with Anubis faster. We are working on a version of this that will run in the documentation via WebAssembly.\n\n### Open Graph configuration is being moved to the policy file\n\nAnubis supports reading [Open Graph tags](/docs/admin/configuration/open-graph) from target services and returning them in challenge pages. This makes the right metadata show up when linking services protected by Anubis in chat applications or on social media.\n\nIn order to test the migration of all of the configuration to the policy file, Open Graph configuration has been moved to the policy file. For more information, please read [the Open Graph configuration options](/docs/admin/configuration/open-graph#configuration-options).\n\nYou can also set default Open Graph tags:\n\n```yaml\nopenGraph:\n enabled: true\n ttl: 24h\n # If set, return these opengraph values instead of looking them up with\n # the target service.\n #\n # Correlates to properties in https://ogp.me/\n override:\n # og:title is required, it is the title of the website\n \"og:title\": \"Techaro Anubis\"\n \"og:description\": >-\n Anubis is a Web AI Firewall Utility that helps you fight the bots\n away so that you can maintain uptime at work!\n \"description\": >-\n Anubis is a Web AI Firewall Utility that helps you fight the bots\n away so that you can maintain uptime at work!\n```\n\n## Improvements and optimizations\n\nOne of the biggest improvements we've made in v1.20.0 is replacing [SHA-256 with xxhash](https://github.com/TecharoHQ/anubis/pull/676). Anubis uses hashes all over the place to help with identifying clients, matching against rules when allowing traffic through, in error messages sent to users, and more. Historically these have been done with [SHA-256](https://en.wikipedia.org/wiki/SHA-2), however this has been having a mild performance impact in real-world use. As a result, we now use [xxhash](https://xxhash.com/) when possible. This makes policy matching 3x faster in some scenarios and reduces memory usage across the board.\n\nAnubis now uses [bart](https://pkg.go.dev/github.com/gaissmai/bart) for doing IP address matching when you specify addresses in a `remote_address` check configuration or when you are matching against [advanced checks](/docs/admin/thoth). This uses the same kind of IP address routing configuration that your OS kernel does, making it very fast to query information about IP addresses. This makes IP address range matches anywhere from 3-14 times faster depending on the number of addresses it needs to match against. For more information and benchmarks, check out [@JasonLovesDoggo](https://github.com/JasonLovesDoggo)'s PR: [perf: replace cidranger with bart for significant performance improvements #675](https://github.com/TecharoHQ/anubis/pull/675).\n\n## What's up next?\n\nv1.21.0 is already shaping up to be a massive improvement as Anubis adds [internationalization](https://en.wikipedia.org/wiki/Internationalization) support, allowing your users to see its messages in the language they're most comfortable with.\n\nSo far Anubis supports the following languages:\n\n- English (Simplified and Traditional)\n- French\n- Portuguese (Brazil)\n- Spanish\n\nIf you want to contribute translations, please [file an issue](https://github.com/TecharoHQ/anubis/issues/new) with your language of choice or submit a pull request to [the `lib/localization/locales` folder](https://github.com/TecharoHQ/anubis/tree/main/lib/localization/locales). We are about to introduce features to the translation stack, so you may want to hold off a hot minute, but we welcome any and all contributions to making Anubis useful to a global audience.\n\nOther things we plan to do:\n\n- Move configuration to the policy file\n- Support reloading the policy file at runtime without having to restart Anubis\n- Detecting if a client is \"brand new\"\n- A [Valkey](https://valkey.io/)-backed store for sharing information between instances of Anubis\n- Augmenting No-JS support in the paid product\n- TLS fingerprinting\n- Automated testing improvements in CI (FreeBSD CI support, better automated integration/functional testing, etc.)\n\n## Conclusion\n\nI hope that these features let you get the same Anubis power you've come to know and love and increases the things you can do with it! I've been really excited to ship [thresholds](/docs/admin/configuration/thresholds) and the cloud-based services for Anubis.\n\nIf you run into any problems, please [file an issue](https://github.com/TecharoHQ/anubis/issues/new). Otherwise, have a good day and get back to making your communities great.\n"
},
{
"path": "docs/blog/2025-07-09-incident-report/index.mdx",
"content": "---\nslug: incident/TI-20250709-0001\ntitle: \"TI-20250709-0001: IPv4 traffic failures for Techaro services\"\nauthors: [xe]\ntags: [incident]\nimage: ./window-portal.jpg\n---\n\n\n\nTecharo services were down for IPv4 traffic on July 9th, 2025. This blogpost is a report of what happened, what actions were taken to resolve the situation, and what actions are being done in the near future to prevent this problem. Enjoy this incident report!\n\n{/* truncate */}\n\n:::note\n\nIn other companies, this kind of documentation would be kept internal. At Techaro, we believe that you deserve radical candor and the truth. As such, we are proving our lofty words with actions by publishing details about how things go wrong publicly.\n\nEverything past this point follows my standard incident root cause meeting template.\n\n:::\n\nThis incident report will focus on the services affected, timeline of what happened at which stage of the incident, where we got lucky, the root cause analysis, and what action items are being planned or taken to prevent this from happening in the future.\n\n## Timeline\n\nAll events take place on July 9th, 2025.\n\n| Time (UTC) | Description |\n| :--------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| 12:32 | Uptime Kuma reports that another unrelated website on the same cluster was timing out. |\n| 12:33 | Uptime Kuma reports that Thoth's production endpoint is failing gRPC health checks. |\n| 12:35 | Investigation begins, [announcement made on Xe's Bluesky](https://bsky.app/profile/xeiaso.net/post/3ltjtdczpwc2x) due to the impact including their personal blog. |\n| 12:39 | `nginx-ingress` logs on the production cluster show IPv6 traffic but an abrupt cutoff in IPv4 traffic around 12:32 UTC. Ticket is opened with the hosting provider. |\n| 12:41 | IPv4 traffic resumes long enough for Uptime Kuma to report uptime, but then immediately fails again. |\n| 12:46 | IPv4 traffic resumes long enough for Uptime Kuma to report uptime, but then immediately fails again. (repeat instances of this have been scrubbed, but it happened about every 5-10 minutes) |\n| 12:48 | First reply from the hosting provider. |\n| 12:57 | Reply to hosting provider, ask to reboot the load balancer. |\n| 13:00 | Incident responder because busy due to a meeting under the belief that the downtime was out of their control and that uptime monitoring software would let them know if it came back up. |\n| 13:20 | Incident responder ended meeting and went back to monitoring downtime and preparing this document. |\n| 13:34 | IPv4 traffic starts to show up in the `ingress-nginx` logs. |\n| 13:35 | All services start to report healthy. Incident status changes to monitoring. |\n| 13:48 | Incident closed. |\n| 14:07 | Incident re-opened. Issues seem to be manifesting as BGP issues in the upstream provider. |\n| 14:10 | IPv4 traffic resumes and then stops. |\n| 14:18 | IPv4 traffic resumes again. Incident status changes to monitoring. |\n| 14:40 | Incident closed. |\n\n## Services affected\n\n| Service name | User impact |\n| :-------------------------------------------------- | :----------------- |\n| [Anubis Docs](https://anubis.techaro.lol) (IPv4) | Connection timeout |\n| [Anubis Docs](https://anubis.techaro.lol) (IPv6) | None |\n| [Thoth](/docs/admin/thoth/) (IPv4) | Connection timeout |\n| [Thoth](/docs/admin/thoth/) (IPv6) | None |\n| Other websites colocated on the same cluster (IPv4) | Connection timeout |\n| Other websites colocated on the same cluster (IPv6) | None |\n\n## Root cause analysis\n\nIn simplify server management, Techaro runs a [Kubernetes](https://kubernetes.io/) cluster on [Vultr VKE](https://www.vultr.com/kubernetes/) (Vultr Kubernetes Engine). When you do this, Vultr needs to provision a [load balancer](https://docs.vultr.com/how-to-use-a-vultr-load-balancer-with-vke) to bridge the gap between the outside world and the Kubernetes world, kinda like this:\n\n```mermaid\n---\ntitle: Overall architecture\n---\n\nflowchart LR\n UT(User Traffic)\n subgraph Provider Infrastructure\n LB[Load Balancer]\n end\n subgraph Kubernetes\n IN(ingress-nginx)\n TH(Thoth)\n AN(Anubis Docs)\n OS(Other sites)\n\n IN --> TH\n IN --> AN\n IN --> OS\n end\n\n UT --> LB --> IN\n```\n\nTecharo controls everything inside the Kubernetes side of that diagram. Anything else is out of our control. That load balancer is routed to the public internet via [Border Gateway Protocol (BGP)](https://en.wikipedia.org/wiki/Border_Gateway_Protocol).\n\nIf there is an interruption with the BGP sessions in the upstream provider, this can manifest as things either not working or inconsistently working. This is made more difficult by the fact that the IPv4 and IPv6 internets are technically separate networks. With this in mind, it's very possible to have IPv4 traffic fail but not IPv6 traffic.\n\nThe root cause is that the hosting provider we use for production services had flapping IPv4 BGP sessions in its Toronto region. When this happens all we can do is open a ticket and wait for it to come back up.\n\n## Where we got lucky\n\nThe Uptime Kuma instance that caught this incident runs on an IPv4-only network. If it was dual stack, this would not have been caught as quickly.\n\nThe `ingress-nginx` logs print IP addresses of remote clients to the log feed. If this was not the case, it would be much more difficult to find this error.\n\n## Action items\n\n- A single instance of downtime like this is not enough reason to move providers. Moving providers because of this is thus out of scope.\n- Techaro needs a status page hosted on a different cloud provider than is used for the production cluster (`TecharoHQ/TODO#6`).\n- Health checks for IPv4 and IPv6 traffic need to be created (`TecharoHQ/TODO#7`).\n- Remove the requirement for [Anubis to pass Thoth health checks before it can start if Thoth is enabled](https://github.com/TecharoHQ/anubis/pull/794).\n"
},
{
"path": "docs/blog/2025-07-22-release-1.21.1/index.mdx",
"content": "---\nslug: release/v1.21.1\ntitle: Anubis v1.21.1 is now available!\nauthors: [xe]\ntags: [release]\nimage: anubis-i18n.webp\n---\n\n\n\nHey all!\n\nRecently we released [Anubis v1.21.1: Minfilia Warde (Echo 1)](https://github.com/TecharoHQ/anubis/releases/tag/v1.21.1). This is a fairly meaty release and like [last time](../2025-06-27-release-1.20.0/index.mdx) this blogpost will tell you what you need to know before you update. Kick back, get some popcorn and let's dig into this!\n\n{/* truncate */}\n\nIn this release, Anubis becomes internationalized, gains the ability to use system load as input to issuing challenges, finally fixes the \"invalid response\" after \"success\" bug, and more! Please read these notes before upgrading as the changes are big enough that administrators should take action to ensure that the upgrade goes smoothly.\n\nThis release is brought to you by [FreeCAD](https://www.freecad.org/), an open-source computer aided design tool that lets you design things for the real world.\n\n## What's in this release?\n\nThe biggest change is that the [\"invalid response\" after \"success\" bug](https://github.com/TecharoHQ/anubis/issues/564) is now finally fixed for good by totally rewriting how [Anubis' challenge issuance flow works](#challenge-flow-v2).\n\nThis release gives Anubis the following features:\n\n- [Internationalization support](#internationalization), allowing Anubis to render its messages in the human language you speak.\n- Anubis now supports the [`missingHeader`](#missingHeader-function) function to assert the absence of headers in requests.\n- Anubis now has the ability to [store data persistently on the server](#persistent-data-storage).\n- Anubis can use [the system load average](#load-average-checks) as a factor to determine if it needs to filter traffic or not.\n- Add `COOKIE_SECURE` option to set the cookie [Secure flag](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies#block_access_to_your_cookies)\n- Sets cookie defaults to use [SameSite: None](https://web.dev/articles/samesite-cookies-explained)\n- Allow [Common Crawl](https://commoncrawl.org/) by default so scrapers have less incentive to scrape\n- Add `/healthz` metrics route for use in platform-based health checks.\n- Start exposing JA4H fingerprints for later use in CEL expressions.\n\nAnd this release also fixes the following bugs:\n\n- [Challenge issuance has been totally rewritten](#challenge-flow-v2) to finally squash the infamous [\"invalid response\" after \"success\" bug](https://github.com/TecharoHQ/anubis/issues/564) for good.\n- In order to reduce confusion, the \"Success\" interstitial that shows up when you pass a proof of work challenge has been removed.\n- Don't block Anubis starting up if [Thoth](/docs/admin/thoth/) health checks fail.\n- The \"Try again\" button on the error page has been fixed. Previously it meant \"try the solution again\" instead of \"try the challenge again\".\n- In certain cases, a user could be stuck with a test cookie that is invalid, locking them out of the service for up to half an hour. This has been fixed with better validation of this case and clearing the cookie.\n- \"Proof of work\" has been removed from the branding due to some users having extremely negative connotations with it.\n\nWe try to avoid introducing breaking changes as much as possible, but these are the changes that may be relevant for you as an administrator:\n\n- The [challenge format](#challenge-format-change) has been changed in order to account for [the new challenge issuance flow](#challenge-flow-v2).\n- The [systemd service `RuntimeDirectory` has been changed](#breaking-change-systemd-runtimedirectory-change).\n\n### Sponsoring the project\n\nIf you rely on Anubis to keep your website safe, please consider sponsoring the project on [GitHub Sponsors](https://github.com/sponsors/Xe) or [Patreon](https://patreon.com/cadey). Funding helps pay hosting bills and offset the time spent on making this project the best it can be. Every little bit helps and when enough money is raised, [I can make Anubis my full-time job](https://github.com/TecharoHQ/anubis/discussions/278).\n\nOnce this pie chart is at 100%, I can start to reduce my hours at my day job as most of my needs will be met (pre-tax):\n\n```mermaid\npie title Funding update\n \"GitHub Sponsors\" : 29\n \"Patreon\" : 14\n \"Remaining\" : 56\n```\n\nI am waiting to hear back from NLNet on if Anubis was selected for funding or not. Let's hope it is!\n\n## New features\n\n### Internationalization\n\nAnubis now supports localized responses. Locales can be added in [lib/localization/locales/](https://github.com/TecharoHQ/anubis/tree/main/lib/localization/locales). This release includes support for the following languages:\n\n- [Brazilian Portuguese](https://github.com/TecharoHQ/anubis/pull/726)\n- [Chinese (Simplified)](https://github.com/TecharoHQ/anubis/pull/774)\n- [Chinese (Traditional)](https://github.com/TecharoHQ/anubis/pull/759)\n- [Czech](https://github.com/TecharoHQ/anubis/pull/849)\n- English\n- [Estonian](https://github.com/TecharoHQ/anubis/pull/783)\n- [Filipino](https://github.com/TecharoHQ/anubis/pull/775)\n- [Finnish](https://github.com/TecharoHQ/anubis/pull/863)\n- [French](https://github.com/TecharoHQ/anubis/pull/716)\n- [German](https://github.com/TecharoHQ/anubis/pull/741)\n- [Japanese](https://github.com/TecharoHQ/anubis/pull/772)\n- [Icelandic](https://github.com/TecharoHQ/anubis/pull/780)\n- [Italian](https://github.com/TecharoHQ/anubis/pull/778)\n- [Norwegian](https://github.com/TecharoHQ/anubis/pull/855)\n- [Russian](https://github.com/TecharoHQ/anubis/pull/882)\n- [Spanish](https://github.com/TecharoHQ/anubis/pull/716)\n- [Turkish](https://github.com/TecharoHQ/anubis/pull/751)\n\nIf facts or local regulations demand, you can set Anubis default language with the `FORCED_LANGUAGE` environment variable or the `--forced-language` command line argument:\n\n```sh\nFORCED_LANGUAGE=de\n```\n\n## Big ticket bug fixes\n\nThese issues affect every user of Anubis. Administrators should upgrade Anubis as soon as possible to mitigate them.\n\n### Fix event loop thrashing when solving a proof of work challenge\n\nAnubis has a progress bar so that users can have something moving while it works. This gives users more confidence that something is happening and that the website is not being malicious with CPU usage. However, the way it was implemented way back in [#87](https://github.com/TecharoHQ/anubis/pull/87) had a subtle bug:\n\n```js\nif (\n (nonce > oldNonce) | 1023 && // we've wrapped past 1024\n (nonce >> 10) % threads === threadId // and it's our turn\n) {\n postMessage(nonce);\n}\n```\n\nThe logic here looks fine but is subtly wrong as was reported in [#877](https://github.com/TecharoHQ/anubis/issues/877) by the main Pale Moon developer.\n\nFor context, `nonce` is a counter that increments by the worker count every loop. This is intended to spread the load between CPU cores as such:\n\n| Iteration | Worker ID | Nonce |\n| :-------- | :-------- | :---- |\n| 1 | 0 | 0 |\n| 1 | 1 | 1 |\n| 2 | 0 | 2 |\n| 2 | 1 | 3 |\n\nAnd so on. This makes the proof of work challenge as fast as it can possibly be so that Anubis quickly goes away and you can enjoy the service it is protecting.\n\nThe incorrect part of this is the boolean logic, specifically the part with the bitwise or `|`. I think the intent was to use a logical or (`||`), but this had the effect of making the `postMessage` handler fire on every iteration. The intent of this snippet (as the comment clearly indicates) is to make sure that the main event loop is only updated with the worker status every 1024 iterations per worker. This had the opposite effect, causing a lot of messages to be sent from workers to the parent JavaScript context.\n\nThis is bad for the event loop.\n\nInstead, I have ripped out that statement and replaced it with a much simpler increment only counter that fires every 1024 iterations. Additionally, only the first thread communicates back to the parent process. This does mean that in theory the other workers could be ahead of the first thread (posting a message out of a worker has a nonzero cost), but in practice I don't think this will be as much of an issue as the current behaviour is.\n\nThe root cause of the stack exhaustion is likely the pressure caused by all of the postMessage futures piling up. Maybe the larger stack size in 64 bit environments is causing this to be fine there, maybe it's some combination of newer hardware in 64 bit systems making this not be as much of a problem due to it being able to handle events fast enough to keep up with the pressure.\n\nEither way, thanks much to [@wolfbeast](https://github.com/wolfbeast) and the Pale Moon community for finding this. This will make Anubis faster for everyone!\n\n### Fix potential memory leak when discovering a solution\n\nIn some cases, the parallel solution finder in Anubis could cause all of the worker promises to leak due to the fact the promises were being improperly terminated. A recursion bomb happens in the following scenario:\n\n1. A worker sends a message indicating it found a solution to the proof of work challenge.\n2. The `onmessage` handler for that worker calls `terminate()`\n3. Inside `terminate()`, the parent process loops through all other workers and calls `w.terminate()` on them.\n4. It's possible that terminating a worker could lead to the `onerror` event handler.\n5. This would create a recursive loop of `onmessage` -> `terminate` -> `onerror` -> `terminate` -> `onerror` and so on.\n\nThis infinite recursion quickly consumes all available stack space, but this has never been noticed in development because all of my computers have at least 64Gi of ram provisioned to them under the axiom paying for more ram is cheaper than paying in my time spent having to work around not having enough ram. Additionally, ia32 has a smaller base stack size, which means that they will run into this issue much sooner than users on other CPU architectures will.\n\nThe fix adds a boolean `settled` flag to prevent termination from running more than once.\n\n## Expressions features\n\nAnubis v1.21.1 adds additional [expressions](/docs/admin/configuration/expressions) features so that you can make your request matching even more granular.\n\n### `missingHeader` function\n\nAnubis [expressions](/docs/admin/configuration/expressions) have [a few functions exposed](/docs/admin/configuration/expressions/#functions-exposed-to-anubis-expressions). Anubis v1.21.1 adds the `missingHeader` function, allowing you to assert the _absence_ of a header in requests.\n\nLet's say you're getting a lot of requests from clients that are pretending to be Google Chrome. Google Chrome sends a few signals to web servers, the main one of them is the [`Sec-Ch-Ua`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Sec-CH-UA). Sec-CH-UA is part of Google's [User Agent Client Hints](https://wicg.github.io/ua-client-hints/#sec-ch-ua) proposal, but it being present is a sign that the client is more likely Google Chrome than not. With the `missingHeader` function, you can write a rule to [add weight](/docs/admin/policies/#request-weight) to requests without `Sec-Ch-Ua` that claim to be Google Chrome.\n\n```yaml\n# Adds weight clients that claim to be Google Chrome without setting Sec-Ch-Ua\n- name: old-chrome\n action: WEIGH\n weight:\n adjust: 10\n expression:\n all:\n - userAgent.matches(\"Chrome/[1-9][0-9]?\\\\.0\\\\.0\\\\.0\")\n - missingHeader(headers, \"Sec-Ch-Ua\")\n```\n\nWhen combined with [weight thresholds](/docs/admin/configuration/thresholds), this allows you to make requests that don't match the signature of Google Chrome more suspicious, which will make them have a more difficult challenge.\n\n### Load average checks\n\nAnubis can dynamically take action [based on the system load average](/docs/admin/configuration/expressions/#using-the-system-load-average), allowing you to write rules like this:\n\n```yaml\n## System load based checks.\n# If the system is under high load for the last minute, add weight.\n- name: high-load-average\n action: WEIGH\n expression: load_1m >= 10.0 # make sure to end the load comparison in a .0\n weight:\n adjust: 20\n\n# If it is not for the last 15 minutes, remove weight.\n- name: low-load-average\n action: WEIGH\n expression: load_15m <= 4.0 # make sure to end the load comparison in a .0\n weight:\n adjust: -10\n```\n\nSomething to keep in mind about system load average is that it is not aware of the number of cores the system has. If you have a 16 core system that has 16 processes running but none of them is hogging the CPU, then you will get a load average below 16. If you are in doubt, make your \"high load\" metric at least two times the number of CPU cores and your \"low load\" metric at least half of the number of CPU cores. For example:\n\n| Kind | Core count | Load threshold |\n| --------: | :--------- | :------------- |\n| high load | 4 | `8.0` |\n| low load | 4 | `2.0` |\n| high load | 16 | `32.0` |\n| low load | 16 | `8` |\n\nAlso keep in mind that this does not account for other kinds of latency like I/O latency or downstream API response latency. A system can have its web applications unresponsive due to high latency from a MySQL server but still have that web application server report a load near or at zero.\n\n:::note\n\nThis does not work if you are using Kubernetes.\n\n:::\n\nWhen combined with [weight thresholds](/docs/admin/configuration/thresholds), this allows you to make incoming sessions \"back off\" while the server is under high load.\n\n## Challenge flow v2\n\nThe main goal of Anubis is to weigh the risks of incoming requests in order to protect upstream resources against abusive clients like badly written scrapers. In order to separate \"good\" clients (like users wanting to learn from a website's content) from \"bad\" clients, Anubis issues [challenges](/docs/admin/configuration/challenges/).\n\nPreviously the Anubis challenge flow looked like this:\n\n```mermaid\n---\ntitle: Old Anubis challenge flow\n---\nflowchart LR\n user(User Browser)\n subgraph Anubis\n mIC{Challenge?}\n ic(Issue Challenge)\n rp(Proxy to service)\n mIC -->|User needs a challenge| ic\n mIC -->|User does not need a challenge| rp\n end\n target(Target Service)\n rp --> target\n user --> mIC\n ic -->|Pass a challenge| user\n target -->|Site data| users\n```\n\nIn order to issue a challenge, Anubis generated a challenge string based on request metadata that we assumed wouldn't drastically change between requests, including but not limited to:\n\n- The client's User-Agent string.\n- The client [`Accept-Language` header](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Accept-Language) value.\n- The client's IP address.\n\nAnubis also didn't store any information about challenges so that it can remain lightweight and handle the onslaught of requests from scrapers. The assumption was that the challenge string function was idempotent per client across time. What actually ended up happening was something like this:\n\n```mermaid\n---\ntitle: Anubis challenge string idempotency\n---\nsequenceDiagram\n User->>+Anubis: GET /wiki/some-page\n Anubis->>+Make Challenge: Generate a challenge string\n Make Challenge->>-Anubis: Challenge string: taco salad\n Anubis->>-User: HTTP 401 solve a challenge\n User->>+Anubis: GET internal-api/pass-challenge\n Anubis->>+Make Challenge: Generate a challenge string\n Make Challenge->>-Anubis: Challenge string: burrito bar\n Anubis->>+User: Error: invalid response\n```\n\nVarious attempts were made to fix this. All of these ended up failing. Many difficulties were discovered including but not limited to:\n\n- Removing `Accept-Language` from consideration because [Chrome randomizes the contents of `Accept-Language` to reduce fingerprinting](https://github.com/explainers-by-googlers/reduce-accept-language), a behaviour which [causes a lot of confusion](https://www.reddit.com/r/chrome/comments/nhpnez/google_chrome_is_randomly_switching_languages_on/) for users with multiple system languages selected.\n- [IPv6 privacy extensions](https://www.internetsociety.org/resources/deploy360/2014/privacy-extensions-for-ipv6-slaac/) mean that each request could be coming from a different IP address (at least one legitimate user in the wild has been observed to have a different IP address per TCP session across an entire `/48`).\n- Some [US mobile phone carriers make it too easy for your IP address to drastically change](https://news.ycombinator.com/item?id=32038215) without user input.\n- [Happy eyeballs](https://en.wikipedia.org/wiki/Happy_Eyeballs) means that some requests can come in over IPv4 and some requests can come in over IPv6.\n- To make things worse, you can't even assert that users are from the same [BGP autonomous system](<https://en.wikipedia.org/wiki/Autonomous_system_(Internet)>) because some users could have ISPs that are IPv4 only, forcing them to use a different IP address space to get IPv6 internet access. This sounds like it's rare enough, but I personally have to do this even though I pay for 8 gigabit fiber from my ISP and only get IPv4 service from them.\n\nAmusingly enough, the only part of this that has survived is the assertion that a user hasn't changed their `User-Agent` string. Maybe [that one guy that sets his Chrome version to `150`](https://github.com/TecharoHQ/anubis/issues/239) would have issues, but so far I've not seen any evidence that a client randomly changing their user agent between challenge issuance and solving can possibly be legitimate.\n\nAs a result, the entire subsystem that generated challenges before had to be ripped out and rewritten from scratch.\n\nIt was replaced with a new flow that stores data on the server side, compares that data against what the client responds with, and then checks pass/fail that way:\n\n```mermaid\n---\ntitle: New challenge flow\n---\nsequenceDiagram\n User->>+Anubis: GET /wiki/some-page\n Anubis->>+Make Challenge: Generate a challenge string\n Make Challenge->>+Store: Store info for challenge 1234\n Make Challenge->>-Anubis: Challenge string: taco salad, ID 1234\n Anubis->>-User: HTTP 401 solve a challenge\n User->>+Anubis: GET internal-api/pass-challenge, challenge 1234\n Anubis->>+Validate Challenge: verify challenge 1234\n Validate Challenge->>+Store: Get info for challenge 1234\n Store->>-Validate Challenge: Here you go!\n Validate Challenge->>-Anubis: Valid ✅\n Anubis->>+User: Here's a cookie to get past Anubis\n```\n\nAs a result, the [challenge format](#challenge-format-change) had to change. Old cookies will still be validated, but the next minor version (v1.22.0) will include validation to ensure that all challenges are accounted for on the server side. This data is stored in the active [storage backend](/docs/admin/policies/#storage-backends) for up to 30 minutes. This also fixes [#746](https://github.com/TecharoHQ/anubis/issues/746) and other similar instances of this issue.\n\n### Challenge format change\n\nPreviously Anubis did no accounting for challenges that it issued. This means that if Anubis restarted during a client, the client would be able to proceed once Anubis came back online.\n\nDuring the upgrade to v1.21.0 and when v1.21.0 (or later) restarts with the [in-memory storage backend](/docs/admin/policies/#memory), you may see a higher rate of failed challenges than normal. If this persists beyond a few minutes, [open an issue](https://github.com/TecharoHQ/anubis/issues/new).\n\nIf you are using the in-memory storage backend, please consider using [a different storage backend](/docs/admin/policies/#storage-backends).\n\n### Storage\n\nAnubis offers a few different storage backends depending on your needs:\n\n| Backend | Description |\n| :--------------------------------------- | :------------------------------------------------------------------------------------------------------------- |\n| [`memory`](/docs/admin/policies/#memory) | An in-memory hashmap that is cleared when Anubis is restarted. |\n| [`bbolt`](/docs/admin/policies/#bbolt) | A memory-mapped key/value store that can persist between Anubis restarts. |\n| [`valkey`](/docs/admin/policies/#valkey) | A networked key/value store that can persist between Anubis restarts and coordinate across multiple instances. |\n\nPlease review the documentation for each storage method to figure out the one best for your needs. If you aren't sure, consult this diagram:\n\n```mermaid\n---\ntitle: What storage backend do I need?\n---\nflowchart TD\n OneInstance{Do you only have\none instance of\nAnubis?}\n Persistence{Do you have\npersistent disk\naccess in your\nenvironment?}\n bbolt[(bbolt)]\n memory[(memory)]\n valkey[(valkey)]\n OneInstance -->|Yes| Persistence\n OneInstance -->|No| valkey\n Persistence -->|Yes| bbolt\n Persistence -->|No| memory\n```\n\n## Breaking change: systemd `RuntimeDirectory` change\n\nThe following potentially breaking change applies to native installs with systemd only:\n\nEach instance of systemd service template now has a unique `RuntimeDirectory`, as opposed to each instance of the service sharing a `RuntimeDirectory`. This change was made to avoid [the `RuntimeDirectory` getting nuked](https://github.com/TecharoHQ/anubis/issues/748) any time one of the Anubis instances restarts.\n\nIf you configured Anubis' unix sockets to listen on `/run/anubis/foo.sock` for instance `anubis@foo`, you will need to configure Anubis to listen on `/run/anubis/foo/foo.sock` and additionally configure your HTTP load balancer as appropriate.\n\nIf you need the legacy behaviour, install this [systemd unit dropin](https://www.flatcar.org/docs/latest/setup/systemd/drop-in-units/):\n\n```systemd\n# /etc/systemd/system/anubis@.service.d/50-runtimedir.conf\n[Service]\nRuntimeDirectory=anubis\n```\n\nJust keep in mind that this will cause problems when Anubis restarts.\n\n## What's up next?\n\nThe biggest things we want to do in the next release (in no particular order):\n\n- A rewrite of bot checking rule configuration syntax to make it less ambiguous.\n- [JA4](https://blog.foxio.io/ja4+-network-fingerprinting) (and other forms of) fingerprinting and coordination with [Thoth](/docs/admin/thoth/) to allow clients with high aggregate pass rates through without seeing Anubis at all.\n- Advanced heuristics for [users of the unbranded variant of Anubis](/docs/admin/botstopper/).\n- Optimize the release flow so that releases can be triggered and executed by continuous integration tools. The ultimate goal is to make it possible to release Anubis in 15 minutes after pressing a single \"mint release\" button.\n- Add \"hot reloading\" support to Anubis, allowing administrators to update the rules without restarting the service.\n- Fix [multiple slash support](https://github.com/TecharoHQ/anubis/issues/754) for web applications that require optional path variables.\n- Add weight to \"brand new\" clients.\n- Implement a \"maze\" feature that tries to get crawlers ensnared in a maze of random links so that clients that are more than 20 links in can be reported to the home base.\n- Open [Thoth-based advanced checks](/docs/admin/thoth/) to more users with an easier onboarding flow.\n- More smoke tests including for browsers like [Pale Moon](https://www.palemoon.org/).\n"
},
{
"path": "docs/blog/2025-08-18-funding-update/index.mdx",
"content": "---\nslug: 2025/funding-update\ntitle: Funding update\nauthors: [xe]\ntags: [funding]\nimage: around-the-bend.webp\n---\n\n\n\nAs we finish up work on [all of the features in the next release of Anubis](/docs/CHANGELOG#unreleased), I took a moment to add up the financials and here's an update on the recurring revenue of the project. Once I reach the [$5000 per month](https://github.com/TecharoHQ/anubis/discussions/278) mark, I can start reducing hours at my dayjob and start to make working on Anubis my full time job.\n\n{/* truncate */}\n\nNote that this only counts _recurring_ revenue (subscriptions to [BotStopper](/docs/admin/botstopper) and monthly repeating donations). Every one of the one-time donations I get is a gift and I am grateful for them, but I cannot make critically important financial decisions off of sporadic one-time donations.\n\n:::note\n\nAll currency figures in this article are USD (United States Dollars) unless denoted otherwise.\n\n:::\n\nHere's the funding breakdown by income stream:\n\n```mermaid\npie title Funding update August 2025\n \"GitHub Sponsors\" : 3500\n \"Patreon\" : 1500\n \"Liberapay\" : 100\n \"Remaining\" : 4800\n```\n\nAssuming that some of my private support contracts and other sales effort go through, this will slightly change the shapes of this (a new pie chart segment will emerge for \"Manual invoices\"), but I am halfway there. This is a huge bar to pass and as it stands right now this is just enough income to pay for my monthly rent (not accounting for tax).\n\nAs a reminder, here's the rough plan for the phases I want to hit based on the _recurring_ donation totals:\n\n| Monthly donations | Details |\n| :-------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| $0-5,000 per month | Anubis is a nights and weekends project based on how much spare time and energy I have. |\n| $5,000-10,000 per month | Anubis gets 1-2 days per week of my time put into it consistently and I go part-time at my dayjob. |\n| $10,000-15,000 per month | Anubis becomes my full time job. Features that are currently exclusive to [BotStopper](/docs/admin/botstopper/) start to trickle down to the open source version of Anubis. |\n| $15,000 per month and above | I start planning hiring for Techaro. |\n\nIf your organization benefits from Anubis, please consider donating to the project in order to make this sustainable. The fewer financial problems I have means the more that Anubis can become better.\n\n## New funding platform: Liberapay\n\nAfter many comments about the funding options, I have set up [Liberapay](https://liberapay.com/Xe/) as an option to receive donations. Additional funding targets will be added to Liberapay as soon as I hear back from my accountant with more information. All money received via Liberapay goes directly towards supporting the project.\n\n## Next goals\n\nHere's my short term goals for the immediate future:\n\n1. Finish [Thoth](/docs/admin/thoth/) and run a backfill to mass issue API keys.\n2. Document and publish the writeup for the multi-region Google Cloud spot instance setup that Thoth is built upon.\n3. Release v1.22.0 of Anubis with Traefik support and other important fixes.\n4. Continue growing the project into a sustainable business.\n5. Work through the [blog backlog](https://github.com/TecharoHQ/anubis/issues?q=is%3Aissue%20state%3Aopen%20label%3Ablog) to document the thoughts behind Anubis and how parts of it work.\n\nThank you for supporting Anubis! It's only going to get better from here.\n"
},
{
"path": "docs/blog/2025-08-28-cpu-core-odd/ProofOfWorkDiagram/index.jsx",
"content": "import React, { useState, useEffect, useMemo } from \"react\";\nimport styles from \"./styles.module.css\";\n\n// A helper function to perform SHA-256 hashing.\n// It takes a string, encodes it, hashes it, and returns a hex string.\nasync function sha256(message) {\n try {\n const msgBuffer = new TextEncoder().encode(message);\n const hashBuffer = await crypto.subtle.digest(\"SHA-256\", msgBuffer);\n const hashArray = Array.from(new Uint8Array(hashBuffer));\n const hashHex = hashArray\n .map((b) => b.toString(16).padStart(2, \"0\"))\n .join(\"\");\n return hashHex;\n } catch (error) {\n console.error(\"Hashing failed:\", error);\n return \"Error hashing data\";\n }\n}\n\n// Generates a random hex string of a given byte length\nconst generateRandomHex = (bytes = 16) => {\n const buffer = new Uint8Array(bytes);\n crypto.getRandomValues(buffer);\n return Array.from(buffer)\n .map((byte) => byte.toString(16).padStart(2, \"0\"))\n .join(\"\");\n};\n\n// Icon components for better visual feedback\nconst CheckIcon = () => (\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n className={styles.iconGreen}\n fill=\"none\"\n viewBox=\"0 0 24 24\"\n stroke=\"currentColor\"\n >\n <path\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n strokeWidth={2}\n d=\"M9 12l2 2 4-4m6 2a9 9 0 11-18 0 9 9 0 0118 0z\"\n />\n </svg>\n);\n\nconst XCircleIcon = () => (\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n className={styles.iconRed}\n fill=\"none\"\n viewBox=\"0 0 24 24\"\n stroke=\"currentColor\"\n >\n <path\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n strokeWidth={2}\n d=\"M10 14l2-2m0 0l2-2m-2 2l-2-2m2 2l2 2m7-2a9 9 0 11-18 0 9 9 0 0118 0z\"\n />\n </svg>\n);\n\n// Main Application Component\nexport default function App() {\n // State for the challenge, initialized with a random 16-byte hex string.\n const [challenge, setChallenge] = useState(() => generateRandomHex(16));\n // State for the nonce, which is the variable we can change\n const [nonce, setNonce] = useState(0);\n // State to store the resulting hash\n const [hash, setHash] = useState(\"\");\n // A flag to indicate if the current hash is the \"winning\" one\n const [isMining, setIsMining] = useState(false);\n const [isFound, setIsFound] = useState(false);\n\n // The mining difficulty, i.e., the required number of leading zeros\n const difficulty = \"00\";\n\n // Memoize the combined data to avoid recalculating on every render\n const combinedData = useMemo(\n () => `${challenge}${nonce}`,\n [challenge, nonce],\n );\n\n // This effect hook recalculates the hash whenever the combinedData changes.\n useEffect(() => {\n let isMounted = true;\n const calculateHash = async () => {\n const calculatedHash = await sha256(combinedData);\n if (isMounted) {\n setHash(calculatedHash);\n setIsFound(calculatedHash.startsWith(difficulty));\n }\n };\n calculateHash();\n return () => {\n isMounted = false;\n };\n }, [combinedData, difficulty]);\n\n // This effect handles the automatic mining process\n useEffect(() => {\n if (!isMining) return;\n\n let miningNonce = nonce;\n let continueMining = true;\n\n const mine = async () => {\n while (continueMining) {\n const currentData = `${challenge}${miningNonce}`;\n const currentHash = await sha256(currentData);\n\n if (currentHash.startsWith(difficulty)) {\n setNonce(miningNonce);\n setIsMining(false);\n break;\n }\n\n miningNonce++;\n // Update the UI periodically to avoid freezing the browser\n if (miningNonce % 100 === 0) {\n setNonce(miningNonce);\n await new Promise((resolve) => setTimeout(resolve, 0)); // Yield to the browser\n }\n }\n };\n\n mine();\n\n return () => {\n continueMining = false;\n };\n }, [isMining, challenge, nonce, difficulty]);\n\n const handleMineClick = () => {\n setIsMining(true);\n };\n\n const handleStopClick = () => {\n setIsMining(false);\n };\n\n const handleResetClick = () => {\n setIsMining(false);\n setNonce(0);\n };\n\n const handleNewChallengeClick = () => {\n setIsMining(false);\n setChallenge(generateRandomHex(16));\n setNonce(0);\n };\n\n // Helper to render the hash with colored leading characters\n const renderHash = () => {\n if (!hash) return <span>...</span>;\n const prefix = hash.substring(0, difficulty.length);\n const suffix = hash.substring(difficulty.length);\n const prefixColor = isFound ? styles.hashPrefixGreen : styles.hashPrefixRed;\n return (\n <>\n <span className={`${prefixColor} ${styles.hashPrefix}`}>{prefix}</span>\n <span className={styles.hashSuffix}>{suffix}</span>\n </>\n );\n };\n\n return (\n <div className={styles.container}>\n <div className={styles.innerContainer}>\n <div className={styles.grid}>\n {/* Challenge Block */}\n <div className={styles.block}>\n <h2 className={styles.blockTitle}>1. Challenge</h2>\n <p className={styles.challengeText}>{challenge}</p>\n </div>\n\n {/* Nonce Control Block */}\n <div className={styles.block}>\n <h2 className={styles.blockTitle}>2. Nonce</h2>\n <div className={styles.nonceControls}>\n <button\n onClick={() => setNonce((n) => n - 1)}\n disabled={isMining}\n className={styles.nonceButton}\n >\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n className={styles.iconSmall}\n fill=\"none\"\n viewBox=\"0 0 24 24\"\n stroke=\"currentColor\"\n >\n <path\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n strokeWidth={2}\n d=\"M20 12H4\"\n />\n </svg>\n </button>\n <span className={styles.nonceValue}>{nonce}</span>\n <button\n onClick={() => setNonce((n) => n + 1)}\n disabled={isMining}\n className={styles.nonceButton}\n >\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n className={styles.iconSmall}\n fill=\"none\"\n viewBox=\"0 0 24 24\"\n stroke=\"currentColor\"\n >\n <path\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n strokeWidth={2}\n d=\"M12 4v16m8-8H4\"\n />\n </svg>\n </button>\n </div>\n </div>\n\n {/* Combined Data Block */}\n <div className={styles.block}>\n <h2 className={styles.blockTitle}>3. Combined Data</h2>\n <p className={styles.combinedDataText}>{combinedData}</p>\n </div>\n </div>\n\n {/* Arrow pointing down */}\n <div className={styles.arrowContainer}>\n <svg\n xmlns=\"http://www.w3.org/2000/svg\"\n className={styles.iconGray}\n fill=\"none\"\n viewBox=\"0 0 24 24\"\n stroke=\"currentColor\"\n >\n <path\n strokeLinecap=\"round\"\n strokeLinejoin=\"round\"\n strokeWidth={2}\n d=\"M19 14l-7 7m0 0l-7-7m7 7V3\"\n />\n </svg>\n </div>\n\n {/* Hash Output Block */}\n <div\n className={`${styles.hashContainer} ${isFound ? styles.hashContainerSuccess : styles.hashContainerError}`}\n >\n <div className={styles.hashContent}>\n <div className={styles.hashText}>\n <h2 className={styles.blockTitle}>4. Resulting Hash (SHA-256)</h2>\n <p className={styles.hashValue}>{renderHash()}</p>\n </div>\n <div className={styles.hashIcon}>\n {isFound ? <CheckIcon /> : <XCircleIcon />}\n </div>\n </div>\n </div>\n\n {/* Mining Controls */}\n <div className={styles.buttonContainer}>\n {!isMining ? (\n <button\n onClick={handleMineClick}\n className={`${styles.button} ${styles.buttonCyan}`}\n >\n Auto-Mine\n </button>\n ) : (\n <button\n onClick={handleStopClick}\n className={`${styles.button} ${styles.buttonYellow}`}\n >\n Stop Mining\n </button>\n )}\n <button\n onClick={handleNewChallengeClick}\n className={`${styles.button} ${styles.buttonIndigo}`}\n >\n New Challenge\n </button>\n <button\n onClick={handleResetClick}\n className={`${styles.button} ${styles.buttonGray}`}\n >\n Reset Nonce\n </button>\n </div>\n </div>\n </div>\n );\n}\n"
},
{
"path": "docs/blog/2025-08-28-cpu-core-odd/ProofOfWorkDiagram/styles.module.css",
"content": "/* Main container styles */\n.container {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: center;\n color: white;\n font-family: ui-sans-serif, system-ui, sans-serif;\n margin-top: 2rem;\n margin-bottom: 2rem;\n}\n\n.innerContainer {\n width: 100%;\n max-width: 56rem;\n margin: 0 auto;\n}\n\n/* Header styles */\n.header {\n text-align: center;\n margin-bottom: 2.5rem;\n}\n\n.title {\n font-size: 2.25rem;\n font-weight: 700;\n color: rgb(34 211 238);\n}\n\n.subtitle {\n font-size: 1.125rem;\n color: rgb(156 163 175);\n margin-top: 0.5rem;\n}\n\n/* Grid layout styles */\n.grid {\n display: grid;\n grid-template-columns: repeat(3, 1fr);\n gap: 1rem;\n align-items: center;\n text-align: center;\n}\n\n/* Block styles */\n.block {\n background-color: rgb(31 41 55);\n padding: 1.5rem;\n border-radius: 0.5rem;\n box-shadow:\n 0 10px 15px -3px rgb(0 0 0 / 0.1),\n 0 4px 6px -4px rgb(0 0 0 / 0.1);\n height: 100%;\n display: flex;\n flex-direction: column;\n justify-content: center;\n}\n\n.blockTitle {\n font-size: 1.125rem;\n font-weight: 600;\n color: rgb(34 211 238);\n margin-bottom: 0.5rem;\n}\n\n.challengeText {\n font-size: 0.875rem;\n color: rgb(209 213 219);\n word-break: break-all;\n font-family: ui-monospace, SFMono-Regular, monospace;\n}\n\n.combinedDataText {\n font-size: 0.875rem;\n color: rgb(156 163 175);\n word-break: break-all;\n font-family: ui-monospace, SFMono-Regular, monospace;\n}\n\n/* Nonce control styles */\n.nonceControls {\n display: flex;\n align-items: center;\n justify-content: center;\n gap: 1rem;\n}\n\n.nonceButton {\n background-color: rgb(55 65 81);\n border-radius: 9999px;\n padding: 0.5rem;\n transition: background-color 200ms;\n}\n\n.nonceButton:hover:not(:disabled) {\n background-color: rgb(34 211 238);\n}\n\n.nonceButton:disabled {\n opacity: 0.5;\n cursor: not-allowed;\n}\n\n.nonceValue {\n font-size: 1.5rem;\n font-family: ui-monospace, SFMono-Regular, monospace;\n width: 6rem;\n text-align: center;\n}\n\n/* Icon styles */\n.icon {\n height: 2rem;\n width: 2rem;\n}\n\n.iconGreen {\n height: 2rem;\n width: 2rem;\n color: rgb(74 222 128);\n}\n\n.iconRed {\n height: 2rem;\n width: 2rem;\n color: rgb(248 113 113);\n}\n\n.iconSmall {\n height: 1.5rem;\n width: 1.5rem;\n}\n\n.iconGray {\n height: 2.5rem;\n width: 2.5rem;\n color: rgb(75 85 99);\n animation: pulse 2s cubic-bezier(0.4, 0, 0.6, 1) infinite;\n}\n\n/* Arrow animation */\n@keyframes pulse {\n 0%,\n 100% {\n opacity: 1;\n }\n 50% {\n opacity: 0.5;\n }\n}\n\n.arrowContainer {\n display: flex;\n justify-content: center;\n margin: 1.5rem 0;\n}\n\n/* Hash output styles */\n.hashContainer {\n padding: 1.5rem;\n border-radius: 0.5rem;\n box-shadow:\n 0 10px 15px -3px rgb(0 0 0 / 0.1),\n 0 4px 6px -4px rgb(0 0 0 / 0.1);\n transition: all 300ms;\n border: 2px solid;\n}\n\n.hashContainerSuccess {\n background-color: rgb(20 83 45 / 0.5);\n border-color: rgb(74 222 128);\n}\n\n.hashContainerError {\n background-color: rgb(127 29 29 / 0.5);\n border-color: rgb(248 113 113);\n}\n\n.hashContent {\n display: flex;\n flex-direction: column;\n align-items: center;\n justify-content: space-between;\n}\n\n.hashText {\n text-align: center;\n}\n\n.hashTextLg {\n text-align: left;\n}\n\n.hashValue {\n font-size: 0.875rem;\n word-break: break-all;\n}\n\n.hashValueLg {\n font-size: 1rem;\n word-break: break-all;\n}\n\n.hashIcon {\n margin-top: 1rem;\n}\n\n.hashIconLg {\n margin-top: 0;\n}\n\n/* Hash highlighting */\n.hashPrefix {\n font-family: ui-monospace, SFMono-Regular, monospace;\n}\n\n.hashPrefixGreen {\n color: rgb(74 222 128);\n}\n\n.hashPrefixRed {\n color: rgb(248 113 113);\n}\n\n.hashSuffix {\n font-family: ui-monospace, SFMono-Regular, monospace;\n color: rgb(156 163 175);\n}\n\n/* Button styles */\n.buttonContainer {\n margin-top: 2rem;\n display: flex;\n align-items: center;\n justify-content: center;\n gap: 1rem;\n}\n\n.button {\n font-weight: 700;\n padding: 0.75rem 1.5rem;\n border-radius: 0.5rem;\n transition: transform 150ms;\n}\n\n.button:hover {\n transform: scale(1.05);\n}\n\n.buttonCyan {\n background-color: rgb(8 145 178);\n color: white;\n}\n\n.buttonCyan:hover {\n background-color: rgb(6 182 212);\n}\n\n.buttonYellow {\n background-color: rgb(202 138 4);\n color: white;\n}\n\n.buttonYellow:hover {\n background-color: rgb(245 158 11);\n}\n\n.buttonIndigo {\n background-color: rgb(79 70 229);\n color: white;\n}\n\n.buttonIndigo:hover {\n background-color: rgb(99 102 241);\n}\n\n.buttonGray {\n background-color: rgb(55 65 81);\n color: white;\n}\n\n.buttonGray:hover {\n background-color: rgb(75 85 99);\n}\n\n/* Responsive styles */\n@media (min-width: 768px) {\n .title {\n font-size: 3rem;\n }\n\n .grid {\n grid-template-columns: repeat(3, 1fr);\n gap: 1rem;\n }\n\n .hashContent {\n flex-direction: row;\n }\n\n .hashText {\n text-align: left;\n }\n\n .hashValue {\n font-size: 1rem;\n }\n\n .hashIcon {\n margin-top: 0;\n }\n}\n\n@media (max-width: 767px) {\n .grid {\n display: flex;\n flex-direction: column;\n gap: 1rem;\n }\n}\n\n@media (prefers-color-scheme: light) {\n .block {\n background-color: oklch(93% 0.034 272.788);\n }\n\n .challengeText {\n color: oklch(12.9% 0.042 264.695);\n }\n\n .combinedDataText {\n color: oklch(12.9% 0.042 264.695);\n }\n\n .nonceButton {\n background-color: oklch(88.2% 0.059 254.128);\n }\n\n .nonceValue {\n color: oklch(12.9% 0.042 264.695);\n }\n\n .blockTitle {\n color: oklch(45% 0.085 224.283);\n }\n\n .hashContainerSuccess {\n background-color: oklch(95% 0.052 163.051);\n border-color: rgb(74 222 128);\n }\n\n .hashContainerError {\n background-color: oklch(94.1% 0.03 12.58);\n border-color: rgb(248 113 113);\n }\n\n .hashPrefixGreen {\n color: oklch(53.2% 0.157 131.589);\n font-weight: 600;\n }\n\n .hashPrefixRed {\n color: oklch(45.5% 0.188 13.697);\n }\n\n .hashSuffix {\n color: oklch(27.9% 0.041 260.031);\n }\n}\n"
},
{
"path": "docs/blog/2025-08-28-cpu-core-odd/index.mdx",
"content": "---\nslug: 2025/cpu-core-odd\ntitle: Sometimes CPU cores are odd\ndescription: \"TL;DR: all the assumptions you have about processor design are wrong and if you are unlucky you will never run into problems that users do through sheer chance.\"\nauthors: [xe]\ntags:\n - bugfix\n - implementation\nimage: parc-dsilence.webp\n---\n\nimport ProofOfWorkDiagram from \"./ProofOfWorkDiagram\";\n\n\n\nOne of the biggest lessons that I've learned in my career is that all software has bugs, and the more complicated your software gets the more complicated your bugs get. A lot of the time those bugs will be fairly obvious and easy to spot, validate, and replicate. Sometimes, the process of fixing it will uncover your core assumptions about how things work in ways that will leave you feeling like you just got trolled.\n\nToday I'm going to talk about a single line fix that prevents people on a large number of devices from having weird irreproducible issues with Anubis rejecting people when it frankly shouldn't. Stick around, it's gonna be a wild ride.\n\n{/* truncate */}\n\n## How this happened\n\nAnubis is a web application firewall that tries to make sure that the client is a browser. It uses a few [challenge methods](/docs/admin/configuration/challenges/) to do this determination, but the main method is the [proof of work](/docs/admin/configuration/challenges/proof-of-work/) challenge which makes clients grind away at cryptographic checksums in order to rate limit clients from connecting too eagerly.\n\n:::note\n\nIn retrospect implementing the proof of work challenge may have been a mistake and it's likely to be supplanted by things like [Proof of React](https://github.com/TecharoHQ/anubis/pull/1038) or other methods that have yet to be developed. Your patience and polite behaviour in the bug tracker is appreciated.\n\n:::\n\nIn order to make sure the proof of work challenge screen _goes away as fast as possible_, the [worker code](https://github.com/TecharoHQ/anubis/tree/main/web/js/worker) is optimized within an inch of its digital life. One of the main ways that this code is optimized is with how it's run. Over the last 10-20 years, the main way that CPUs have gotten fast is via increasing multicore performance. Anubis tries to make sure that it can use as many cores as possible in order to take advantage of your device's CPU as much as it can.\n\nThis strategy sometimes has some issues though, for one Firefox seems to get _much slower_ if you have Anubis try to absolutely saturate all of the cores on the system. It also has a fairly high overhead between JavaScript JIT code and [WebCrypto](https://developer.mozilla.org/en-US/docs/Web/API/Web_Crypto_API). I did some testing and found out that Firefox's point of diminishing returns was about half of the CPU cores.\n\n## Another \"invalid response\" bug\n\nOne of the complaints I've been getting from users and administrators using Anubis is that they've been running into issues where users get randomly rejected with an error message only saying \"invalid response\". This happens when the challenge validating process fails. This issue has been blocking the release of the next version of Anubis.\n\nIn order to demonstrate this better, I've made a little interactive diagram for the proof of work process:\n\n<ProofOfWorkDiagram />\n\nI've fixed a lot of the easy bugs in Anubis by this point. A lot of what's left is the hard bugs, but also specifically the kinds of hard bugs that involve weird hardware configurations. In order to try and catch these issues before software hits prod, I test Anubis against a bunch of hardware I have locally. Any issues I find and fix before software ships are issues that you don't hit in production.\n\nLet's consider [the line of code](https://github.com/TecharoHQ/anubis/blob/main/web/js/algorithms/fast.mjs) that was causing this issue:\n\n```js\nthreads = Math.max(navigator.hardwareConcurrency / 2, 1),\n```\n\nThis is intended to make your browser spawn a proof of work worker for _half_ of your available CPU cores. If you only have one CPU core, you should only have one worker. Each thread is given this number of threads and uses that to increment the nonce so that each thread doesn't try to find a solution that another worker has already performed.\n\nOne of the subtle problems here is that all of the parts of this assume that the thread ID and nonce are integers without a decimal portion. Famously, [all JavaScript numbers are IEEE 754 floating point numbers](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Number). Surely there wouldn't be a case where the thread count could be a _decimal_ number, right?\n\nHere's all the devices I use to test Anubis _and their core counts_:\n\n| Device Name | Core Count |\n| :--------------------------- | :--------- |\n| MacBook Pro M3 Max | 16 |\n| MacBook Pro M4 Max | 16 |\n| AMD Ryzen 9 7950x3D | 32 |\n| Google Pixel 9a (GrapheneOS) | 8 |\n| iPhone 15 Pro Max | 6 |\n| iPad Pro (M1) | 8 |\n| iPad mini | 6 |\n| Steam Deck | 8 |\n| Core i5 10600 (homelab) | 12 |\n| ROG Ally | 16 |\n\nNotice something? All of those devices have an _even_ number of cores. Some devices such as the [Pixel 8 Pro](https://www.gsmarena.com/google_pixel_8_pro-12545.php) have an _odd_ number of cores. So what happens with that line of code as the JavaScript engine evaluates it?\n\nLet's replace the [`navigator.hardwareConcurrency`](https://developer.mozilla.org/en-US/docs/Web/API/Navigator/hardwareConcurrency) with the Pixel 8 Pro's 9 cores:\n\n```js\nthreads = Math.max(9 / 2, 1),\n```\n\nThen divide it by two:\n\n```js\nthreads = Math.max(4.5, 1),\n```\n\nOops, that's not ideal. However `4.5` is bigger than `1`, so [`Math.max`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/max) returns that:\n\n```js\nthreads = 4.5,\n```\n\nThis means that each time the proof of work equation is calculated, there is a 50% chance that a valid solution would include a nonce with a decimal portion in it. If the client finds a solution with such a nonce, then it would think the client was successful and submit the solution to the server, but the server only expects whole numbers back so it rejects that as an invalid response.\n\nI keep telling more junior people that when you have the weirdest, most inconsistent bugs in software that it's going to boil down to the dumbest possible thing you can possibly imagine. People don't believe me, then they encounter bugs like this. Then they suddenly believe me.\n\nHere is the fix:\n\n```js\nthreads = Math.trunc(Math.max(navigator.hardwareConcurrency / 2, 1)),\n```\n\nThis uses [`Math.trunc`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Math/trunc) to truncate away the decimal portion so that the Pixel 8 Pro has `4` workers instead of `4.5` workers.\n\n## Today I learned this was possible\n\nThis was a total \"today I learned\" moment. I didn't actually think that hardware vendors shipped processors with an odd number of cores, however if you look at the core geometry of the Pixel 8 Pro, it has _three_ tiers of processor cores:\n\n| Core type | Core model | Number |\n| :----------------- | :------------------- | :----- |\n| High performance | 3 Ghz Cortex X3 | 1 |\n| Medium performance | 2.45 Ghz Cortex A715 | 4 |\n| High efficiency | 2.15 Cortex A510 | 4 |\n| Total | | 9 |\n\nI guess every assumption that developers have about CPU design is probably wrong.\n\nThis probably isn't helped by the fact that for most of my career, the core count in phones has been largely irrelevant and most of the desktop / laptop CPUs I've had (where core count does matter) uses [simultaneous multithreading](https://en.wikipedia.org/wiki/Simultaneous_multithreading) to \"multiply\" the core count by two.\n\nThe client side fix is a bit of an \"emergency stop\" button to try and mitigate the badness as early as possible. In general I'm quite aware of the terrible UX involved with this flow failing and I'm still noodling through ways to make that UX better and easier for users / administrators to debug.\n\nI'm looking into the following:\n\n1. This could have been prevented on the server side by doing less strict input validation in compliance with [Postel's Law](https://en.wikipedia.org/wiki/Robustness_principle). I feel nervous about making such a security-sensitive endpoint _more liberal_ with the inputs it can accept, but it may be fine? I need to consult with a security expert.\n2. Showing an encrypted error message on the \"invalid response\" page so that the user and administrator can work together to fix or report the issue. I remember Google doing this at least once, but I can't recall where I've seen it in the past. Either way, this is probably the most robust method even though it would require developing some additional tooling. I think it would be worth it.\n\nI'm likely going to go with the second option. I will need to figure out a good flow for this. It's likely going to involve [age](https://github.com/FiloSottile/age). I'll say more about this when I have more to say.\n\nIn the meantime though, looks like I need to expense a used Pixel 8 Pro to add to the testing jungle for Anubis. If anyone has a deal out there, please let me know!\n\nThank you to the people that have been polite and helpful when trying to root cause and fix this issue.\n"
},
{
"path": "docs/blog/2025-10-31-file-abuse-reports/index.mdx",
"content": "---\nslug: 2025/file-abuse-reports\ntitle: Taking steps to end abusive traffic from cloud providers\ndescription: \"Learn how to effectively file abuse reports with cloud providers to stop malicious traffic at its source and protect your services from automated abuse.\"\nauthors: [xe]\ntags: [abuse, cloud, security, networking]\nimage: goose-pond.webp\n---\n\n\n\nAs part of Anubis's ongoing development, I've been working to reduce friction for legitimate users by minimizing unnecessary challenge pages. While this improves the user experience, it can potentially expose services to increased abuse from public cloud infrastructure. To help administrators better protect their services, I want to share my strategies for filing abuse reports with IP space owners, enabling us to address malicious scraping at its source.\n\n{/* truncate */}\n\nIn general, there are two kinds of IP addresses:\n\n- Residential IP addresses: IP addresses that are allocated to residential customers such as home internet connections and cellular data plans. These IP addresses are increasingly shared between customers due to technologies like [CGNAT](https://en.wikipedia.org/wiki/Carrier-grade_NAT).\n- Commercial IP addresses: IP addresses that are allocated to commercial customers such as cloud providers, VPS providers, root server providers, and other such business to business companies. These IP addresses are almost always statically allocated to one customer for a very long period of time (typically the lifetime of the server unless they are using things like dedicated IP addresses).\n\nIn general, filing abuse reports to residential IP addresses is a waste of time. The administrators do appreciate knowing what kinds of abusive traffic is causing grief, but many times the users of those IP addresses don't know that their computer is sending abusive traffic to your services. A lot of malware botnets that used to be used with DDOS for hire services are now being used as residential proxies. Those \"free VPN apps\" are almost certainly making you pay for your usage by making your computer a zombie in a botnet. At some level I really respect the hustle as they manage to sell other people's bandwidth for rates as ludicrous as $1.00 per gigabyte ingressed and egressed.\n\n:::note\n\nKeep in mind, I'm talking about the things you can find by searching \"free VPN\", not infrastructure for the public good like the Tor browser or I2P.\n\n:::\n\nWhat you should really focus on is traffic from commercial IP addresses, such as cloud providers. That's a case where the cloud customer is in direct violation of the acceptable use policy of the provider. Filing abuse reports gets the abuse team of the cloud provider to reach out to that customer and demand corrective action under threat of contractual violence.\n\n## How to make an abuse report\n\nIn general, the best abuse reports contain the following information:\n\n- Time of abusive requests.\n- IP address, User-Agent header, or other unique identifiers that can help the abuse team educate the customer about their misbehaving infrastructure.\n- Does the abusive IP address request robots.txt? If not, be sure to include that information.\n- A brief description of the impact to your system such as high system load, pages not rendering, or database system crashes. This helps the provider establish the fact that their customer is causing you measurable harm.\n- Context as to what your service is, what it does, and why they should care.\n\nFor example, let's say that someone was giving the Anubis docs a series of requests that caused the server to fall over and experience extended downtime. Here's what I would write to the abuse contact:\n\n> Hello,\n>\n> I have received abusive traffic from one of your customers that has resulted in a denial of service to the users of the Anubis documentation website. Anubis is a web application firewall that administrators use to protect their websites against mass scraping and this documentation website helps administrators get started.\n>\n> On or about Thursday, October 30th at 04:00 UTC, A flurry of requests from the IP range `127.34.0.0/24` started to hit the `/admin/` routes, which caused unreasonable database load and ended up crashing PostgreSQL. This caused the documentation website to go down for three hours as it happened while the administrators were asleep. Based on logs, this caused 353 distinct users to not be able to load the documentation and the users filed bugs about it.\n>\n> I have attached the HTTP frontend logs for the abusive requests from your IP range. To protect our systems in the meantime while we perform additional hardening, I have blocked that IP address range in both our IP firewall and web application firewall configuration. Based on these logs, your customer seems to not have requested the standard `robots.txt` file, which includes instructions to deny access to those routes.\n>\n> Please let me know what other information you need on your end.\n>\n> Sincerely,\n>\n> [normal email signature]\n\nThen in order to figure out where to send it, look the IP addresses up in the `whois` database. For example, if you want to find the abuse contact for the IP address `1.1.1.1`, use the [whois command](https://packages.debian.org/sid/whois) to find the abuse contact:\n\n```\n$ whois 1.1.1.1 | grep -i abuse\n% Abuse contact for '1.1.1.0 - 1.1.1.255' is 'helpdesk@apnic.net'\nabuse-c: AA1412-AP\nremarks: All Cloudflare abuse reporting can be done via\nremarks: resolver-abuse@cloudflare.com\nabuse-mailbox: helpdesk@apnic.net\nrole: ABUSE APNICRANDNETAU\nabuse-mailbox: helpdesk@apnic.net\nmnt-by: APNIC-ABUSE\n```\n\nThe abuse contact will be named either `abuse-c` or `abuse-mailbox`. For greatest effect, I suggest including all listed email addresses in your email to the abuse contact.\n\nOnce you send your email, you should expect a response within 2 business days at most. If they don't get back to you, please feel free to [contact me](https://xeiaso.net/contact/) so that the default set of Anubis rules can be edited according to patterns I'm seeing across the ecosystem.\n\nJust remember that many cloud providers do not know how bad the scraping problem is. Filing abuse complaints makes it their problem. They don't want it to be their problem.\n"
},
{
"path": "docs/blog/authors.yml",
"content": "xe:\n name: Xe Iaso\n title: CEO @ Techaro\n url: https://github.com/Xe\n image_url: https://github.com/Xe.png\n email: xe@techaro.lol\n page: true\n socials:\n github: Xe\n"
},
{
"path": "docs/docs/CHANGELOG.md",
"content": "---\nsidebar_position: 999\n---\n\n# Changelog\n\nAll notable changes to this project will be documented in this file.\n\nThe format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),\nand this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).\n\n## [Unreleased]\n\n- fix: prevent nil pointer panic in challenge validation when threshold rules match during PassChallenge (#1463)\n- Instruct reverse proxies to not cache error pages.\n- Fixed mixed tab/space indentation in Caddy documentation code block\n\n<!-- This changes the project to: -->\n\n## v1.25.0: Necron\n\nHey all,\n\nI'm sure you've all been aware that things have been slowing down a little with Anubis development, and I want to apologize for that. A lot has been going on in my life lately (my blog will have a post out on Friday with more information), and as a result I haven't really had the energy to work on Anubis in publicly visible ways. There are things going on behind the scenes, but nothing is really shippable yet, sorry!\n\nI've also been feeling some burnout in the wake of perennial waves of anger directed towards me. I'm handling it, I'll be fine, I've just had a lot going on in my life and it's been rough.\n\nI've been missing the sense of wanderlust and discovery that comes with the artistic way I playfully develop software. I suspect that some of the stresses I've been through (setting up a complicated surgery in a country whose language you aren't fluent in is kind of an experience) have been sapping my energy. I'd gonna try to mess with things on my break, but realistically I'm probably just gonna be either watching Stargate SG-1 or doing unreasonable amounts of ocean fishing in Final Fantasy 14. Normally I'd love to keep the details about my medical state fairly private, but I'm more of a public figure now than I was this time last year so I don't really get the invisibility I'm used to for this.\n\nI've also had a fair amount of negativity directed at me for simply being much more visible than the anonymous threat actors running the scrapers that are ruining everything, which though understandable has not helped.\n\nAnyways, it all worked out and I'm about to be in the hospital for a week, so if things go really badly with this release please downgrade to the last version and/or upgrade to the main branch when the fix PR is inevitably merged. I hoped to have time to tame GPG and set up full release automation in the Anubis repo, but that didn't work out this time and that's okay.\n\nIf I can challenge you all to do something, go out there and try to actually create something new somehow. Combine ideas you've never mixed before. Be creative, be human, make something purely for yourself to scratch an itch that you've always had yet never gotten around to actually mending.\n\nAt the very least, try to be an example of how you want other people to act, even when you're in a situation where software written by someone else is configured to require a user agent to execute javascript to access a webpage.\n\nBe well,\n\nXe\n\nPS: if you're well-versed in FFXIV lore, the release title should give you an idea of the kind of stuff I've been going through mentally.\n\n- Add iplist2rule tool that lets admins turn an IP address blocklist into an Anubis ruleset.\n- Add Polish locale ([#1292](https://github.com/TecharoHQ/anubis/pull/1309))\n- Fix honeypot and imprint links missing `BASE_PREFIX` when deployed behind a path prefix ([#1402](https://github.com/TecharoHQ/anubis/issues/1402))\n- Add ANEXIA Sponsor logo to docs ([#1409](https://github.com/TecharoHQ/anubis/pull/1409))\n- Improve idle performance in memory storage\n- Add HAProxy Configurations to Docs ([#1424](https://github.com/TecharoHQ/anubis/pull/1424))\n\n## v1.24.0: Y'shtola Rhul\n\nAnubis is back and better than ever! Lots of minor fixes with some big ones interspersed.\n\n- Fix panic when validating challenges after privacy-mode browsers strip headers and the follow-up request matches an `ALLOW` threshold.\n- Expose WEIGHT rule matches as Prometheus metrics.\n- Allow more OCI registry clients [based on feedback](https://github.com/TecharoHQ/anubis/pull/1253#issuecomment-3506744184).\n- Expose services directory in the embedded `(data)` filesystem.\n- Add Ukrainian locale ([#1044](https://github.com/TecharoHQ/anubis/pull/1044)).\n- Allow Renovate as an OCI registry client.\n- Properly handle 4in6 addresses so that IP matching works with those addresses.\n- Add support to simple Valkey/Redis cluster mode\n- Open Graph passthrough now reuses the configured target Host/SNI/TLS settings, so metadata fetches succeed when the upstream certificate differs from the public domain. ([1283](https://github.com/TecharoHQ/anubis/pull/1283))\n- Stabilize the CVE-2025-24369 regression test by always submitting an invalid proof instead of relying on random POW failures.\n- Refine the check that ensures the presence of the Accept header to avoid breaking docker clients.\n- Removed rules intended to reward actual browsers due to abuse in the wild.\n\n### Dataset poisoning\n\nAnubis has the ability to engage in [dataset poisoning attacks](https://www.anthropic.com/research/small-samples-poison) using the [dataset poisoning subsystem](./admin/honeypot/overview.mdx). This allows every Anubis instance to be a honeypot to attract and flag abusive scrapers so that no administrator action is required to ban them.\n\nThere is much more information about this feature in [the dataset poisoning subsystem documentation](./admin/honeypot/overview.mdx). Administrators that are interested in learning how this feature works should consult that documentation.\n\n### Deprecate `report_as` in challenge configuration\n\nPreviously Anubis let you lie to users about the difficulty of a challenge to interfere with operators of malicious scrapers as a psychological attack:\n\n```yaml\nbots:\n # Punish any bot with \"bot\" in the user-agent string\n # This is known to have a high false-positive rate, use at your own risk\n - name: generic-bot-catchall\n user_agent_regex: (?i:bot|crawler)\n action: CHALLENGE\n challenge:\n difficulty: 16 # impossible\n report_as: 4 # lie to the operator\n algorithm: slow # intentionally waste CPU cycles and time\n```\n\nThis has turned out to be a bad idea because it has caused massive user experience problems and has been removed. If you are using this setting, you will get a warning in your logs like this:\n\n```json\n{\n \"time\": \"2025-11-25T23:10:31.092201549-05:00\",\n \"level\": \"WARN\",\n \"source\": {\n \"function\": \"github.com/TecharoHQ/anubis/lib/policy.ParseConfig\",\n \"file\": \"/home/xe/code/TecharoHQ/anubis/lib/policy/policy.go\",\n \"line\": 201\n },\n \"msg\": \"use of deprecated report_as setting detected, please remove this from your policy file when possible\",\n \"at\": \"config-validate\",\n \"name\": \"mild-suspicion\"\n}\n```\n\nTo remove this warning, remove this setting from your policy file.\n\n### Logging customization\n\nAnubis now supports the ability to log to multiple backends (\"sinks\"). This allows you to have Anubis [log to a file](./admin/policies.mdx#file-sink) instead of just logging to standard out. You can also customize the [logging level](./admin/policies.mdx#log-levels) in the policy file:\n\n```yaml\nlogging:\n level: \"warn\" # much less verbose logging\n sink: file # log to a file\n parameters:\n file: \"./var/anubis.log\"\n maxBackups: 3 # keep at least 3 old copies\n maxBytes: 67108864 # each file can have up to 64 Mi of logs\n maxAge: 7 # rotate files out every n days\n oldFileTimeFormat: 2006-01-02T15-04-05 # RFC 3339-ish\n compress: true # gzip-compress old log files\n useLocalTime: false # timezone for rotated files is UTC\n```\n\nAdditionally, information about [how Anubis uses each logging level](./admin/policies.mdx#log-levels) has been added to the documentation.\n\n### DNS Features\n\n- CEL expressions for:\n - FCrDNS checks\n - Forward DNS queries\n - Reverse DNS queries\n - `arpaReverseIP` to transform IPv4/6 addresses into ARPA reverse IP notation.\n - `regexSafe` to escape regex special characters (useful for including `remoteAddress` or headers in regular expressions).\n- DNS cache and other optimizations to minimize unnecessary DNS queries.\n\nThe DNS cache TTL can be changed in the bots config like this:\n\n```yaml\ndns_ttl:\n forward: 600\n reverse: 600\n```\n\nThe default value for both forward and reverse queries is 300 seconds.\n\nThe `verifyFCrDNS` CEL function has two overloads:\n\n- `(addr)`\n Simply verifies that the remote side has PTR records pointing to the target address.\n- `(addr, ptrPattern)`\n Verifies that the remote side refers to a specific domain and that this domain points to the target IP.\n\n## v1.23.1: Lyse Hext - Echo 1\n\n- Fix `SERVE_ROBOTS_TXT` setting after the double slash fix broke it.\n\n### Potentially breaking changes\n\n#### Remove default Tencent Cloud block rule\n\nv1.23.0 added a default rule to block Tencent Cloud. After an email from their abuse team where they promised to take action to clean up their reputation, I have removed the default block rule. If this network causes you problems, please contact [abuse@tencent.com](mailto:abuse@tencent.com) and supply the following information:\n\n- Time of abusive requests.\n- IP address, User-Agent header, or other unique identifiers that can help the abuse team educate the customer about their misbehaving infrastructure.\n- Does the abusive IP address request robots.txt? If not, be sure to include that information.\n- A brief description of the impact to your system such as high system load, pages not rendering, or database system crashes. This helps the provider establish the fact that their customer is causing you measurable harm.\n- Context as to what your service is, what it does, and why they should care.\n\nMention that you are using Anubis or BotStopper to protect your services. If they do not respond to you, please [contact me](https://xeiaso.net/contact) as soon as possible.\n\n#### Docker / OCI registry clients\n\nAnubis v1.23.0 accidentally blocked Docker / OCI registry clients. In order to explicitly allow them, add an import for `(data)/clients/docker-client.yaml`:\n\n```yaml\nbots:\n - import: (data)/meta/default-config.yaml\n - import: (data)/clients/docker-client.yaml\n```\n\nThis is technically a regression as these clients used to work in Anubis v1.22.0, however it is allowable to make this opt-in as most websites do not expect to be serving Docker / OCI registry client traffic.\n\n## v1.23.0: Lyse Hext\n\n- Add default tencent cloud DENY rule.\n- Added `(data)/meta/default-config.yaml` for importing the entire default configuration at once.\n- Add `-custom-real-ip-header` flag to get the original request IP from a different header than `x-real-ip`.\n- Add `contentLength` variable to bot expressions.\n- Add `COOKIE_SAME_SITE_MODE` to force anubis cookies SameSite value, and downgrade automatically from `None` to `Lax` if cookie is insecure.\n- Fix lock convoy problem in decaymap ([#1103](https://github.com/TecharoHQ/anubis/issues/1103)).\n- Fix lock convoy problem in bbolt by implementing the actor pattern ([#1103](https://github.com/TecharoHQ/anubis/issues/1103)).\n- Remove bbolt actorify implementation due to causing production issues.\n- Document missing environment variables in installation guide: `SLOG_LEVEL`, `COOKIE_PREFIX`, `FORCED_LANGUAGE`, and `TARGET_DISABLE_KEEPALIVE` ([#1086](https://github.com/TecharoHQ/anubis/pull/1086)).\n- Add validation warning when persistent storage is used without setting signing keys.\n- Fixed `robots2policy` to properly group consecutive user agents into `any:` instead of only processing the last one ([#925](https://github.com/TecharoHQ/anubis/pull/925)).\n- Make the `fast` algorithm prefer purejs when running in an insecure context.\n- Add the [`s3api` storage backend](./admin/policies.mdx#s3api) to allow Anubis to use S3 API compatible object storage as its storage backend.\n- Fix a \"stutter\" in the cookie name prefix so the auth cookie is named `techaro.lol-anubis-auth` instead of `techaro.lol-anubis-auth-auth`.\n- Make `cmd/containerbuild` support commas for separating elements of the `--docker-tags` argument as well as newlines.\n- Add the `DIFFICULTY_IN_JWT` option, which allows one to add the `difficulty` field in the JWT claims which indicates the difficulty of the token ([#1063](https://github.com/TecharoHQ/anubis/pull/1063)).\n- Ported the client-side JS to TypeScript to avoid egregious errors in the future.\n- Fixes concurrency problems with very old browsers ([#1082](https://github.com/TecharoHQ/anubis/issues/1082)).\n- Randomly use the Refresh header instead of the meta refresh tag in the metarefresh challenge.\n- Update OpenRC service to truncate the runtime directory before starting Anubis.\n- Make the git client profile more strictly match how the git client behaves.\n- Make the default configuration reward users using normal browsers.\n- Allow multiple consecutive slashes in a row in application paths ([#754](https://github.com/TecharoHQ/anubis/issues/754)).\n- Add option to set `targetSNI` to special keyword 'auto' to indicate that it should be automatically set to the request Host name ([424](https://github.com/TecharoHQ/anubis/issues/424)).\n- The Preact challenge has been removed from the default configuration. It will be deprecated in the future.\n- An open redirect when in subrequest mode has been fixed.\n\n### Potentially breaking changes\n\n#### Multiple checks at once has and-like semantics instead of or-like semantics\n\nAnubis lets you stack multiple checks at once with blocks like this:\n\n```yaml\nname: allow-prometheus\naction: ALLOW\nuser_agent_regex: ^prometheus-probe$\nremote_addresses:\n - 192.168.2.0/24\n```\n\nPreviously, this only returned ALLOW if _any one_ of the conditions matched. This behaviour has changed to only return ALLOW if _all_ of the conditions match. I expect this to have some issues with user configs, however this fix is grave enough that it's worth the risk of breaking configs. If this bites you, please let me know so we can make an escape hatch.\n\n### Better error messages\n\nIn order to make it easier for legitimate clients to debug issues with their browser configuration and Anubis, Anubis will emit internal error detail in base 64 so that administrators can chase down issues. Future versions of this may also include a variant that encrypts the error detail messages.\n\n### Bug Fixes\n\nSometimes the enhanced temporal assurance in [#1038](https://github.com/TecharoHQ/anubis/pull/1038) and [#1068](https://github.com/TecharoHQ/anubis/pull/1068) could backfire because Chromium and its ilk randomize the amount of time they wait in order to avoid a timing side channel attack. This has been fixed by both increasing the amount of time a client has to wait for the metarefresh and preact challenges as well as making the server side logic more permissive.\n\n## v1.22.0: Yda Hext\n\n> Someone has to make an effort at reconciliation if these conflicts are ever going to end.\n\nIn this release, we finally fix the odd number of CPU cores bug, pave the way for lighter weight challenges, make Anubis more adaptable, and more.\n\n### Big ticket items\n\n#### Proof of React challenge\n\nA new [\"proof of React\"](./admin/configuration/challenges/preact.mdx) has been added. It runs a simple app in React that has several chained hooks. It is much more lightweight than the proof of work check.\n\n#### Smaller features\n\n- The [`segments`](./admin/configuration/expressions.mdx#segments) function was added for splitting a path into its slash-separated segments.\n- Added possibility to disable HTTP keep-alive to support backends not properly handling it.\n- When issuing a challenge, Anubis stores information about that challenge into the store. That stored information is later used to validate challenge responses. This works around nondeterminism in bot rules. ([#917](https://github.com/TecharoHQ/anubis/issues/917))\n- One of the biggest sources of lag in Firefox has been eliminated: the use of WebCrypto. Now whenever Anubis detects the client is using Firefox (or Pale Moon), it will swap over to a pure-JS implementation of SHA-256 for speed.\n- Proof of work solving has had a complete overhaul and rethink based on feedback from browser engine developers, frontend experts, and overall performance profiling.\n- Optimize the performance of the pure-JS Anubis solver.\n- Web Workers are stored as dedicated JavaScript files in `static/js/workers/*.mjs`.\n- Pave the way for non-SHA256 solver methods and eventually one that uses WebAssembly (or WebAssembly code compiled to JS for those that disable WebAssembly).\n- Legacy JavaScript code has been eliminated.\n- When parsing [Open Graph tags](./admin/configuration/open-graph.mdx), add any URLs found in the responses to a temporary \"allow cache\" so that social preview images work.\n- The hard dependency on WebCrypto has been removed, allowing a proof of work challenge to work over plain (unencrypted) HTTP.\n- The Anubis version number is put in the footer of every page.\n- Add a default block rule for Huawei Cloud.\n- Add a default block rule for Alibaba Cloud.\n- Added support to use Traefik forwardAuth middleware.\n- Add X-Request-URI support so that Subrequest Authentication has path support.\n- Added glob matching for `REDIRECT_DOMAINS`. You can pass `*.bugs.techaro.lol` to allow redirecting to anything ending with `.bugs.techaro.lol`. There is a limit of 4 wildcards.\n\n### Fixes\n\n#### Odd numbers of CPU cores are properly supported\n\nSome phones have an odd number of CPU cores. This caused [interesting issues](https://anubis.techaro.lol/blog/2025/cpu-core-odd). This was fixed by [using `Math.trunc` to convert the number of CPU cores back into an integer](https://github.com/TecharoHQ/anubis/issues/1043).\n\n#### Smaller fixes\n\n- A standard library HTTP server log message about HTTP pipelining not working has been filtered out of Anubis' logs. There is no action that can be taken about it.\n- Added a missing link to the Caddy installation environment in the installation documentation.\n- Downstream consumers can change the default [log/slog#Logger](https://pkg.go.dev/log/slog#Logger) instance that Anubis uses by setting `opts.Logger` to your slog instance of choice ([#864](https://github.com/TecharoHQ/anubis/issues/864)).\n- The [Thoth client](https://anubis.techaro.lol/docs/admin/thoth) is now public in the repo instead of being an internal package.\n- [Custom-AsyncHttpClient](https://github.com/AsyncHttpClient/async-http-client)'s default User-Agent has an increased weight by default ([#852](https://github.com/TecharoHQ/anubis/issues/852)).\n- Add option for replacing the default explanation text with a custom one ([#747](https://github.com/TecharoHQ/anubis/pull/747))\n- The contact email in the LibreJS header has been changed.\n- Firefox for Android support has been fixed by embedding the challenge ID into the pass-challenge route. This also fixes some inconsistent issues with other mobile browsers.\n- The default `favicon` pattern in `data/common/keep-internet-working.yaml` has been updated to permit requests for png/gif/jpg/svg files as well as ico.\n- The `--cookie-prefix` flag has been fixed so that it is fully respected.\n- The default patterns in `data/common/keep-internet-working.yaml` have been updated to appropriately escape the '.' character in the regular expression patterns.\n- Add optional restrictions for JWT based on the value of a header ([#697](https://github.com/TecharoHQ/anubis/pull/697))\n- The word \"hack\" has been removed from the translation strings for Anubis due to incidents involving people misunderstanding that word and sending particularly horrible things to the project lead over email.\n- Bump AI-robots.txt to version 1.39\n- Inject adversarial input to break AI coding assistants.\n- Add better logging when using Subrequest Authentication.\n\n### Security-relevant changes\n\n- Add a server-side check for the meta-refresh challenge that makes sure clients have waited for at least 95% of the time that they should.\n\n#### Fix potential double-spend for challenges\n\nAnubis operates by issuing a challenge and having the client present a solution for that challenge. Challenges are identified by a unique UUID, which is stored in the database.\n\nThe problem is that a challenge could potentially be used twice by a dedicated attacker making a targeted attack against Anubis. Challenge records did not have a \"spent\" or \"used\" field. In total, a dedicated attacker could solve a challenge once and reuse that solution across multiple sessions in order to mint additional tokens.\n\nThis was fixed by adding a \"spent\" field to challenges in the data store. When a challenge is solved, that \"spent\" field gets set to `true`. If a future attempt to solve this challenge is observed, it gets rejected.\n\nWith the advent of store based challenge issuance in [#749](https://github.com/TecharoHQ/anubis/pull/749), this means that these challenge IDs are [only good for 30 minutes](https://github.com/TecharoHQ/anubis/blob/e8dfff635015d6c906dddd49cb0eaf591326092a/lib/anubis.go#L130-L135d). Websites using the most recent version of Anubis have limited exposure to this problem.\n\nWebsites using older versions of Anubis have a much more increased exposure to this problem and are encouraged to keep this software updated as often and as frequently as possible.\n\nThanks to [@taviso](https://github.com/taviso) for reporting this issue.\n\n### Breaking changes\n\n- The \"slow\" frontend solver has been removed in order to reduce maintenance burden. Any existing uses of it will still work, but issue a warning upon startup asking administrators to upgrade to the \"fast\" frontend solver.\n- The legacy JSON based policy file example has been removed and all documentation for how to write a policy file in JSON has been deleted. JSON based policy files will still work, but YAML is the superior option for Anubis configuration.\n\n### New Locales\n\n- Lithuanian [#972](https://github.com/TecharoHQ/anubis/pull/972)\n- Vietnamese [#926](https://github.com/TecharoHQ/anubis/pull/926)\n\n## v1.21.3: Minfilia Warde - Echo 3\n\n### Added\n\n#### New locales\n\nAnubis now supports these new languages:\n\n- [Swedish](https://github.com/TecharoHQ/anubis/pull/913)\n\n### Fixes\n\n#### Fixes a problem with nonstandard URLs and redirects\n\nFixes [GHSA-jhjj-2g64-px7c](https://github.com/TecharoHQ/anubis/security/advisories/GHSA-jhjj-2g64-px7c).\n\nThis could allow an attacker to craft an Anubis pass-challenge URL that forces a redirect to nonstandard URLs, such as the `javascript:` scheme which executes arbitrary JavaScript code in a browser context when the user clicks the \"Try again\" button.\n\nThis has been fixed by disallowing any URLs without the scheme `http` or `https`.\n\nAdditionally, the \"Try again\" button has been fixed to completely ignore the user-supplied redirect location. It now redirects to the home page (`/`).\n\n## v1.21.2: Minfilia Warde - Echo 2\n\nThis contained an incomplete fix for [GHSA-jhjj-2g64-px7c](https://github.com/TecharoHQ/anubis/security/advisories/GHSA-jhjj-2g64-px7c). Do not use this version.\n\n## v1.21.1: Minfilia Warde - Echo 1\n\n- Expired records are now properly removed from bbolt databases ([#848](https://github.com/TecharoHQ/anubis/pull/848)).\n- Fix hanging on service restart ([#853](https://github.com/TecharoHQ/anubis/issues/853))\n\n### Added\n\nAnubis now supports the [`missingHeader`](./admin/configuration/expressions.mdx#missingHeader) to assert the absence of headers in requests.\n\n#### New locales\n\nAnubis now supports these new languages:\n\n- [Czech](https://github.com/TecharoHQ/anubis/pull/849)\n- [Finnish](https://github.com/TecharoHQ/anubis/pull/863)\n- [Norwegian Bokmål](https://github.com/TecharoHQ/anubis/pull/855)\n- [Norwegian Nynorsk](https://github.com/TecharoHQ/anubis/pull/855)\n- [Russian](https://github.com/TecharoHQ/anubis/pull/882)\n\n### Fixes\n\n#### Fix [\"error: can't get challenge\"](https://github.com/TecharoHQ/anubis/issues/869) when details about a challenge can't be found in the server side state\n\nv1.21.0 changed the core challenge flow to maintain information about challenges on the server side instead of only doing them via stateless idempotent generation functions and relying on details to not change. There was a subtle bug introduced in this change: if a client has an unknown challenge ID set in its test cookie, Anubis will clear that cookie and then throw an HTTP 500 error.\n\nThis has been fixed by making Anubis throw a new challenge page instead.\n\n#### Fix event loop thrashing when solving a proof of work challenge\n\nPreviously the \"fast\" proof of work solver had a fragment of JavaScript that attempted to only post an update about proof of work progress to the main browser window every 1024 iterations. This fragment of JavaScript was subtly incorrect in a way that passed review but actually made the workers send an update back to the main thread every iteration. This caused a pileup of unhandled async calls (similar to a socket accept() backlog pileup in Unix) that caused stack space exhaustion.\n\nThis has been fixed in the following ways:\n\n1. The complicated boolean logic has been totally removed in favour of a worker-local iteration counter.\n2. The progress bar is updated by worker `0` instead of all workers.\n\nHopefully this should limit the event loop thrashing and let ia32 browsers (as well as any environment with a smaller stack size than amd64 and aarch64 seem to have) function normally when processing Anubis proof of work challenges.\n\n#### Fix potential memory leak when discovering a solution\n\nIn some cases, the parallel solution finder in Anubis could cause all of the worker promises to leak due to the fact the promises were being improperly terminated. This was fixed by having Anubis debounce worker termination instead of allowing it to potentially recurse infinitely.\n\n## v1.21.0: Minfilia Warde\n\n> Please, be at ease. You are among friends here.\n\nIn this release, Anubis becomes internationalized, gains the ability to use system load as input to issuing challenges, finally fixes the \"invalid response\" after \"success\" bug, and more! Please read these notes before upgrading as the changes are big enough that administrators should take action to ensure that the upgrade goes smoothly.\n\n### Big ticket changes\n\nThe biggest change is that the [\"invalid response\" after \"success\" bug](https://github.com/TecharoHQ/anubis/issues/564) is now finally fixed for good by totally rewriting how Anubis' challenge issuance flow works. Instead of generating challenge strings from request metadata (under the assumption that the values being compared against are stable), Anubis now generates random data for each challenge. This data is stored in the active [storage backend](./admin/policies.mdx#storage-backends) for up to 30 minutes. This also fixes [#746](https://github.com/TecharoHQ/anubis/issues/746) and other similar instances of this issue.\n\nIn order to reduce confusion, the \"Success\" interstitial that shows up when you pass a proof of work challenge has been removed.\n\n#### Storage\n\nAnubis now is able to store things persistently [in memory](./admin/policies.mdx#memory), [on the disk](./admin/policies.mdx#bbolt), or [in Valkey](./admin/policies.mdx#valkey) (this includes other compatible software). By default Anubis uses the in-memory backend. If you have an environment with mutable storage (even if it is temporary), be sure to configure the [`bbolt`](./admin/policies.mdx#bbolt) storage backend.\n\n#### Localization\n\nAnubis now supports localized responses. Locales can be added in [lib/localization/locales/](https://github.com/TecharoHQ/anubis/tree/main/lib/localization/locales). This release includes support for the following languages:\n\n- [Brazilian Portugese](https://github.com/TecharoHQ/anubis/pull/726)\n- [Chinese (Simplified)](https://github.com/TecharoHQ/anubis/pull/774)\n- [Chinese (Traditional)](https://github.com/TecharoHQ/anubis/pull/759)\n- English\n- [Estonian](https://github.com/TecharoHQ/anubis/pull/783)\n- [Filipino](https://github.com/TecharoHQ/anubis/pull/775)\n- [French](https://github.com/TecharoHQ/anubis/pull/716)\n- [German](https://github.com/TecharoHQ/anubis/pull/741)\n- [Icelandic](https://github.com/TecharoHQ/anubis/pull/780)\n- [Italian](https://github.com/TecharoHQ/anubis/pull/778)\n- [Japanese](https://github.com/TecharoHQ/anubis/pull/772)\n- [Spanish](https://github.com/TecharoHQ/anubis/pull/716)\n- [Turkish](https://github.com/TecharoHQ/anubis/pull/751)\n\nIf facts or local regulations demand, you can set Anubis default language with the `FORCED_LANGUAGE` environment variable or the `--forced-language` command line argument:\n\n```sh\nFORCED_LANGUAGE=de\n```\n\n#### Load average\n\nAnubis can dynamically take action [based on the system load average](./admin/configuration/expressions.mdx#using-the-system-load-average), allowing you to write rules like this:\n\n```yaml\n## System load based checks.\n# If the system is under high load for the last minute, add weight.\n- name: high-load-average\n action: WEIGH\n expression: load_1m >= 10.0 # make sure to end the load comparison in a .0\n weight:\n adjust: 20\n\n# If it is not for the last 15 minutes, remove weight.\n- name: low-load-average\n action: WEIGH\n expression: load_15m <= 4.0 # make sure to end the load comparison in a .0\n weight:\n adjust: -10\n```\n\nSomething to keep in mind about system load average is that it is not aware of the number of cores the system has. If you have a 16 core system that has 16 processes running but none of them is hogging the CPU, then you will get a load average below 16. If you are in doubt, make your \"high load\" metric at least two times the number of CPU cores and your \"low load\" metric at least half of the number of CPU cores. For example:\n\n| Kind | Core count | Load threshold |\n| --------: | :--------- | :------------- |\n| high load | 4 | `8.0` |\n| low load | 4 | `2.0` |\n| high load | 16 | `32.0` |\n| low load | 16 | `8` |\n\nAlso keep in mind that this does not account for other kinds of latency like I/O latency. A system can have its web applications unresponsive due to high latency from a MySQL server but still have that web application server report a load near or at zero.\n\n### Other features and fixes\n\nThere are a bunch of other assorted features and fixes too:\n\n- Add `COOKIE_SECURE` option to set the cookie [Secure flag](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies#block_access_to_your_cookies)\n- Sets cookie defaults to use [SameSite: None](https://web.dev/articles/samesite-cookies-explained)\n- Determine the `BIND_NETWORK`/`--bind-network` value from the bind address ([#677](https://github.com/TecharoHQ/anubis/issues/677)).\n- Implement a [development container](https://containers.dev/) manifest to make contributions easier.\n- Fix dynamic cookie domains functionality ([#731](https://github.com/TecharoHQ/anubis/pull/731))\n- Add option for custom cookie prefix ([#732](https://github.com/TecharoHQ/anubis/pull/732))\n- Make the [Open Graph](./admin/configuration/open-graph.mdx) subsystem and DNSBL subsystem use [storage backends](./admin/policies.mdx#storage-backends) instead of storing everything in memory by default.\n- Allow [Common Crawl](https://commoncrawl.org/) by default so scrapers have less incentive to scrape\n- The [bbolt storage backend](./admin/policies.mdx#bbolt) now runs its cleanup every hour instead of every five minutes.\n- Don't block Anubis starting up if [Thoth](./admin/thoth.mdx) health checks fail.\n- A race condition involving [opening two challenge pages at once in different tabs](https://github.com/TecharoHQ/anubis/issues/832) causing one of them to fail has been fixed.\n- The \"Try again\" button on the error page has been fixed. Previously it meant \"try the solution again\" instead of \"try the challenge again\".\n- In certain cases, a user could be stuck with a test cookie that is invalid, locking them out of the service for up to half an hour. This has been fixed with better validation of this case and clearing the cookie.\n- Start exposing JA4H fingerprints for later use in CEL expressions.\n- Add `/healthz` route for use in platform-based health checks.\n\n### Potentially breaking changes\n\nWe try to introduce breaking changes as much as possible, but these are the changes that may be relevant for you as an administrator:\n\n#### Challenge format change\n\nPreviously Anubis did no accounting for challenges that it issued. This means that if Anubis restarted during a client, the client would be able to proceed once Anubis came back online.\n\nDuring the upgrade to v1.21.0 and when v1.21.0 (or later) restarts with the [in-memory storage backend](./admin/policies.mdx#memory), you may see a higher rate of failed challenges than normal. If this persists beyond a few minutes, [open an issue](https://github.com/TecharoHQ/anubis/issues/new).\n\nIf you are using the in-memory storage backend, please consider using [a different storage backend](./admin/policies.mdx#storage-backends).\n\n#### Systemd service changes\n\nThe following potentially breaking change applies to native installs with systemd only:\n\nEach instance of systemd service template now has a unique `RuntimeDirectory`, as opposed to each instance of the service sharing a `RuntimeDirectory`. This change was made to avoid [the `RuntimeDirectory` getting nuked any time one of the Anubis instances restarts](https://github.com/TecharoHQ/anubis/issues/748).\n\nIf you configured Anubis' unix sockets to listen on `/run/anubis/foo.sock` for instance `anubis@foo`, you will need to configure Anubis to listen on `/run/anubis/foo/foo.sock` and additionally configure your HTTP load balancer as appropriate.\n\nIf you need the legacy behaviour, install this [systemd unit dropin](https://www.flatcar.org/docs/latest/setup/systemd/drop-in-units/):\n\n```systemd\n# /etc/systemd/system/anubis@.service.d/50-runtimedir.conf\n[Service]\nRuntimeDirectory=anubis\n```\n\nJust keep in mind that this will cause problems when Anubis restarts.\n\n## v1.20.0: Thancred Waters\n\nThe big ticket items are as follows:\n\n- Implement a no-JS challenge method: [`metarefresh`](./admin/configuration/challenges/metarefresh.mdx) ([#95](https://github.com/TecharoHQ/anubis/issues/95))\n- Implement request \"weight\", allowing administrators to customize the behaviour of Anubis based on specific criteria\n- Implement GeoIP and ASN based checks via [Thoth](https://anubis.techaro.lol/docs/admin/thoth) ([#206](https://github.com/TecharoHQ/anubis/issues/206))\n- Add [custom weight thresholds](./admin/configuration/thresholds.mdx) via CEL ([#688](https://github.com/TecharoHQ/anubis/pull/688))\n- Move Open Graph configuration [to the policy file](./admin/configuration/open-graph.mdx)\n- Enable support for Open Graph metadata to be returned by default instead of doing lookups against the target\n- Add `robots2policy` CLI utility to convert robots.txt files to Anubis challenge policies using CEL expressions ([#409](https://github.com/TecharoHQ/anubis/issues/409))\n- Refactor challenge presentation logic to use a challenge registry\n- Allow challenge implementations to register HTTP routes\n- [Imprint/Impressum support](./admin/configuration/impressum.mdx) ([#362](https://github.com/TecharoHQ/anubis/issues/362))\n- Fix \"invalid response\" after \"Success!\" in Chromium ([#564](https://github.com/TecharoHQ/anubis/issues/564))\n\nA lot of performance improvements have been made:\n\n- Replace internal SHA256 hashing with xxhash for 4-6x performance improvement in policy evaluation and cache operations\n- Optimized the OGTags subsystem with reduced allocations and runtime per request by up to 66%\n- Replace cidranger with bart for IP range checking, improving IP matching performance by 3-20x with zero heap\n allocations\n\nAnd some cleanups/refactors were added:\n\n- Fix OpenGraph passthrough ([#717](https://github.com/TecharoHQ/anubis/issues/717))\n- Remove the unused `/test-error` endpoint and update the testing endpoint `/make-challenge` to only be enabled in\n development\n- Add `--xff-strip-private` flag/envvar to toggle skipping X-Forwarded-For private addresses or not\n- Bump AI-robots.txt to version 1.37\n- Make progress bar styling more compatible (UXP, etc)\n- Add `--strip-base-prefix` flag/envvar to strip the base prefix from request paths when forwarding to target servers\n- Fix an off-by-one in the default threshold config\n- Add functionality for HS512 JWT algorithm\n- Add support for dynamic cookie domains with the `--cookie-dynamic-domain`/`COOKIE_DYNAMIC_DOMAIN` flag/envvar\n\nRequest weight is one of the biggest ticket features in Anubis. This enables Anubis to be much closer to a Web Application Firewall and when combined with custom thresholds allows administrators to have Anubis take advanced reactions. For more information about request weight, see [the request weight section](./admin/policies.mdx#request-weight) of the policy file documentation.\n\nTL;DR when you have one or more WEIGHT rules like this:\n\n```yaml\nbots:\n - name: gitea-session-token\n action: WEIGH\n expression:\n all:\n - '\"Cookie\" in headers'\n - headers[\"Cookie\"].contains(\"i_love_gitea=\")\n # Remove 5 weight points\n weight:\n adjust: -5\n```\n\nYou can configure custom thresholds like this:\n\n```yaml\nthresholds:\n - name: minimal-suspicion # This client is likely fine, its soul is lighter than a feather\n expression: weight < 0 # a feather weighs zero units\n action: ALLOW # Allow the traffic through\n\n # For clients that had some weight reduced through custom rules, give them a\n # lightweight challenge.\n - name: mild-suspicion\n expression:\n all:\n - weight >= 0\n - weight < 10\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/metarefresh\n algorithm: metarefresh\n difficulty: 1\n report_as: 1\n\n # For clients that are browser-like but have either gained points from custom\n # rules or report as a standard browser.\n - name: moderate-suspicion\n expression:\n all:\n - weight >= 10\n - weight < 20\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 2 # two leading zeros, very fast for most clients\n report_as: 2\n\n # For clients that are browser like and have gained many points from custom\n # rules\n - name: extreme-suspicion\n expression: weight >= 20\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 4\n report_as: 4\n```\n\nThese thresholds apply when no other `ALLOW`, `DENY`, or `CHALLENGE` rule matches the request. `WEIGHT` rules add and remove request weight as needed:\n\n```yaml\nbots:\n - name: gitea-session-token\n action: WEIGH\n expression:\n all:\n - '\"Cookie\" in headers'\n - headers[\"Cookie\"].contains(\"i_love_gitea=\")\n # Remove 5 weight points\n weight:\n adjust: -5\n\n - name: bot-like-user-agent\n action: WEIGH\n expression: '\"Bot\" in userAgent'\n # Add 5 weight points\n weight:\n adjust: 5\n```\n\nOf note: the default \"generic browser\" rule assigns 10 weight points:\n\n```yaml\n# Generic catchall rule\n- name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: WEIGH\n weight:\n adjust: 10\n```\n\nAdjust this as you see fit.\n\n## v1.19.1: Jenomis cen Lexentale - Echo 1\n\n- Return `data/bots/ai-robots-txt.yaml` to avoid breaking configs [#599](https://github.com/TecharoHQ/anubis/issues/599)\n\n## v1.19.0: Jenomis cen Lexentale\n\nMostly a bunch of small features, no big ticket things this time.\n\n- Record if challenges were issued via the API or via embedded JSON in the challenge page HTML ([#531](https://github.com/TecharoHQ/anubis/issues/531))\n- Ensure that clients that are shown a challenge support storing cookies\n- Imprint the version number into challenge pages\n- Encode challenge pages with gzip level 1\n- Add PowerPC 64 bit little-endian builds (`GOARCH=ppc64le`)\n- Add `check-spelling` for spell checking\n- Add `--target-insecure-skip-verify` flag/envvar to allow Anubis to hit a self-signed HTTPS backend\n- Minor adjustments to FreeBSD rc.d script to allow for more flexible configuration.\n- Added Podman and Docker support for running Playwright tests\n- Add a default rule to throw challenges when a request with the `X-Firefox-Ai` header is set\n- Updated the nonce value in the challenge JWT cookie to be a string instead of a number\n- Rename cookies in response to user feedback\n- Ensure cookie renaming is consistent across configuration options\n- Add Bookstack app in data\n- Truncate everything but the first five characters of Accept-Language headers when making challenges\n- Ensure client JavaScript is served with Content-Type text/javascript.\n- Add `--target-host` flag/envvar to allow changing the value of the Host header in requests forwarded to the target service\n- Bump AI-robots.txt to version 1.31\n- Add `RuntimeDirectory` to systemd unit settings so native packages can listen over unix sockets\n- Added SearXNG instance tracker whitelist policy\n- Added Qualys SSL Labs whitelist policy\n- Fixed cookie deletion logic ([#520](https://github.com/TecharoHQ/anubis/issues/520), [#522](https://github.com/TecharoHQ/anubis/pull/522))\n- Add `--target-sni` flag/envvar to allow changing the value of the TLS handshake hostname in requests forwarded to the target service\n- Fixed CEL expression matching validator to now properly error out when it receives empty expressions\n- Added OpenRC init.d script\n- Added `--version` flag\n- Added `anubis_proxied_requests_total` metric to count proxied requests\n- Add `Applebot` as \"good\" web crawler\n- Reorganize AI/LLM crawler blocking into three separate stances, maintaining existing status quo as default\n- Split out AI/LLM user agent blocking policies, adding documentation for each\n\n## v1.18.0: Varis zos Galvus\n\nThe big ticket feature in this release is [CEL expression matching support](https://anubis.techaro.lol/docs/admin/configuration/expressions). This allows you to tailor your approach for the individual services you are protecting.\n\nThese can be as simple as:\n\n```yaml\n- name: allow-api-requests\n action: ALLOW\n expression:\n all:\n - '\"Accept\" in headers'\n - 'headers[\"Accept\"] == \"application/json\"'\n - 'path.startsWith(\"/api/\")'\n```\n\nOr as complicated as:\n\n```yaml\n- name: allow-git-clients\n action: ALLOW\n expression:\n all:\n - >-\n (\n userAgent.startsWith(\"git/\") ||\n userAgent.contains(\"libgit\") ||\n userAgent.startsWith(\"go-git\") ||\n userAgent.startsWith(\"JGit/\") ||\n userAgent.startsWith(\"JGit-\")\n )\n - '\"Git-Protocol\" in headers'\n - headers[\"Git-Protocol\"] == \"version=2\"\n```\n\nThe docs have more information, but here's a tl;dr of the variables you have access to in expressions:\n\n| Name | Type | Explanation | Example |\n| :-------------- | :-------------------- | :---------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------- |\n| `headers` | `map[string, string]` | The [headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers) of the request being processed. | `{\"User-Agent\": \"Mozilla/5.0 Gecko/20100101 Firefox/137.0\"}` |\n| `host` | `string` | The [HTTP hostname](https://web.dev/articles/url-parts#host) the request is targeted to. | `anubis.techaro.lol` |\n| `method` | `string` | The [HTTP method](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods) in the request being processed. | `GET`, `POST`, `DELETE`, etc. |\n| `path` | `string` | The [path](https://web.dev/articles/url-parts#pathname) of the request being processed. | `/`, `/api/memes/create` |\n| `query` | `map[string, string]` | The [query parameters](https://web.dev/articles/url-parts#query) of the request being processed. | `?foo=bar` -> `{\"foo\": \"bar\"}` |\n| `remoteAddress` | `string` | The IP address of the client. | `1.1.1.1` |\n| `userAgent` | `string` | The [`User-Agent`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/User-Agent) string in the request being processed. | `Mozilla/5.0 Gecko/20100101 Firefox/137.0` |\n\nThis will be made more elaborate in the future. Give me time. This is a [simple, lovable, and complete](https://longform.asmartbear.com/slc/) implementation of this feature so that administrators can get hacking ASAP.\n\nOther changes:\n\n- Use CSS variables to deduplicate styles\n- Fixed native packages not containing the stdlib and botPolicies.yaml\n- Change import syntax to allow multi-level imports\n- Changed the startup logging to use JSON formatting as all the other logs do\n- Added the ability to do [expression matching with CEL](./admin/configuration/expressions.mdx)\n- Add a warning for clients that don't store cookies\n- Disable Open Graph passthrough by default ([#435](https://github.com/TecharoHQ/anubis/issues/435))\n- Clarify the license of the mascot images ([#442](https://github.com/TecharoHQ/anubis/issues/442))\n- Started Suppressing 'Context canceled' errors from http in the logs ([#446](https://github.com/TecharoHQ/anubis/issues/446))\n\n## v1.17.1: Asahi sas Brutus: Echo 1\n\n- Added customization of authorization cookie expiration time with `--cookie-expiration-time` flag or envvar\n- Updated the `OG_PASSTHROUGH` to be true by default, thereby allowing Open Graph tags to be passed through by default\n- Added the ability to [customize Anubis' HTTP status codes](./admin/configuration/custom-status-codes.mdx) ([#355](https://github.com/TecharoHQ/anubis/issues/355))\n\n## v1.17.0: Asahi sas Brutus\n\n- Ensure regexes can't end in newlines ([#372](https://github.com/TecharoHQ/anubis/issues/372))\n- Add documentation for default allow behavior (implicit rule)\n- Enable [importing configuration snippets](./admin/configuration/import.mdx) ([#321](https://github.com/TecharoHQ/anubis/pull/321))\n- Refactor check logic to be more generic and work on a Checker type\n- Add more AI user agents based on the [ai.robots.txt](https://github.com/ai-robots-txt/ai.robots.txt) project\n- Embedded challenge data in initial HTML response to improve performance\n- Added support to use Nginx' `auth_request` directive with Anubis\n- Added support to allow to restrict the allowed redirect domains\n- Whitelisted [DuckDuckBot](https://duckduckgo.com/duckduckgo-help-pages/results/duckduckbot/) in botPolicies\n- Improvements to build scripts to make them less independent of the build host\n- Improved the Open Graph error logging\n- Added `Opera` to the `generic-browser` bot policy rule\n- Added FreeBSD rc.d script so can be run as a FreeBSD daemon\n- Allow requests from the Internet Archive\n- Added example nginx configuration to documentation\n- Added example Apache configuration to the documentation [#277](https://github.com/TecharoHQ/anubis/issues/277)\n- Move per-environment configuration details into their own pages\n- Added support for running anubis behind a prefix (e.g. `/myapp`)\n- Added headers support to bot policy rules\n- Moved configuration file from JSON to YAML by default\n- Added documentation on how to use Anubis with Traefik in Docker\n- Improved error handling in some edge cases\n- Disable `generic-bot-catchall` rule because of its high false positive rate in real-world scenarios\n- Moved all CSS inline to the Xess package, changed colors to be CSS variables\n- Set or append to `X-Forwarded-For` header unless the remote connects over a loopback address [#328](https://github.com/TecharoHQ/anubis/issues/328)\n- Fixed mojeekbot user agent regex\n- Reduce Anubis' paranoia with user cookies ([#365](https://github.com/TecharoHQ/anubis/pull/365))\n- Added support for Open Graph passthrough while using unix sockets\n- The Open Graph subsystem now passes the HTTP `HOST` header through to the origin\n- Updated the `OG_PASSTHROUGH` to be true by default, thereby allowing Open Graph tags to be passed through by default\n\n## v1.16.0\n\nFordola rem Lupis\n\n> I want to make them pay! All of them! Everyone who ever mocked or looked down on me -- I want the power to make them pay!\n\nThe following features are the \"big ticket\" items:\n\n- Added support for native Debian, Red Hat, and tarball packaging strategies including installation and use directions\n- A prebaked tarball has been added, allowing distros to build Anubis like they could in v1.15.x\n- The placeholder Anubis mascot has been replaced with a design by [CELPHASE](https://bsky.app/profile/celphase.bsky.social)\n- Verification page now shows hash rate and a progress bar for completion probability\n- Added support for [Open Graph tags](https://ogp.me/) when rendering the challenge page. This allows for social previews to be generated when sharing the challenge page on social media platforms ([#195](https://github.com/TecharoHQ/anubis/pull/195))\n- Added support for passing the ed25519 signing key in a file with `-ed25519-private-key-hex-file` or `ED25519_PRIVATE_KEY_HEX_FILE`\n\nThe other small fixes have been made:\n\n- Added a periodic cleanup routine for the decaymap that removes expired entries, ensuring stale data is properly pruned\n- Added a no-store Cache-Control header to the challenge page\n- Hide the directory listings for Anubis' internal static content\n- Changed `--debug-x-real-ip-default` to `--use-remote-address`, getting the IP address from the request's socket address instead\n- DroneBL lookups have been disabled by default\n- Static asset builds are now done on demand instead of the results being committed to source control\n- The Dockerfile has been removed as it is no longer in use\n- Developer documentation has been added to the docs site\n- Show more errors when some predictable challenge page errors happen ([#150](https://github.com/TecharoHQ/anubis/issues/150))\n- Added the `--debug-benchmark-js` flag for testing proof-of-work performance during development\n- Use `TrimSuffix` instead of `TrimRight` on containerbuild\n- Fix the startup logs to correctly show the address and port the server is listening on\n- Add [LibreJS](https://www.gnu.org/software/librejs/) banner to Anubis JavaScript to allow LibreJS users to run the challenge\n- Added a wait with button continue + 30 second auto continue after 30s if you click \"Why am I seeing this?\"\n- Fixed a typo in the challenge page title\n- Disabled running integration tests on Windows hosts due to it's reliance on posix features (see [#133](https://github.com/TecharoHQ/anubis/pull/133#issuecomment-2764732309))\n- Fixed minor typos\n- Added a Makefile to enable comfortable workflows for downstream packagers\n- Added `zizmor` for GitHub Actions static analysis\n- Fixed most `zizmor` findings\n- Enabled Dependabot\n- Added an air config for autoreload support in development ([#195](https://github.com/TecharoHQ/anubis/pull/195))\n- Added an `--extract-resources` flag to extract static resources to a local folder\n- Add noindex flag to all Anubis pages ([#227](https://github.com/TecharoHQ/anubis/issues/227))\n- Added `WEBMASTER_EMAIL` variable, if it is present then display that email address on error pages ([#235](https://github.com/TecharoHQ/anubis/pull/235), [#115](https://github.com/TecharoHQ/anubis/issues/115))\n- Hash pinned all GitHub Actions\n\n## v1.15.1\n\nZenos yae Galvus: Echo 1\n\nFixes a recurrence of [CVE-2025-24369](https://github.com/Xe/x/security/advisories/GHSA-56w8-8ppj-2p4f)\ndue to an incorrect logic change in a refactor. This allows an attacker to mint a valid\naccess token by passing any SHA-256 hash instead of one that matches the proof-of-work\ntest.\n\nThis case has been added as a regression test. It was not when CVE-2025-24369 was released\ndue to the project not having the maturity required to enable this kind of regression testing.\n\n## v1.15.0\n\nZenos yae Galvus\n\n> Yes...the coming days promise to be most interesting. Most interesting.\n\nHeadline changes:\n\n- ed25519 signing keys for Anubis can be stored in the flag `--ed25519-private-key-hex` or envvar `ED25519_PRIVATE_KEY_HEX`; if one is not provided when Anubis starts, a new one is generated and logged\n- Add the ability to set the cookie domain with the envvar `COOKIE_DOMAIN=techaro.lol` for all domains under `techaro.lol`\n- Add the ability to set the cookie partitioned flag with the envvar `COOKIE_PARTITIONED=true`\n\nMany other small changes were made, including but not limited to:\n\n- Fixed and clarified installation instructions\n- Introduced integration tests using Playwright\n- Refactor & Split up Anubis into cmd and lib.go\n- Fixed bot check to only apply if address range matches\n- Fix default difficulty setting that was broken in a refactor\n- Linting fixes\n- Make dark mode diff lines readable in the documentation\n- Fix CI based browser smoke test\n\nUsers running Anubis' test suite may run into issues with the integration tests on Windows hosts. This is a known issue and will be fixed at some point in the future. In the meantime, use the Windows Subsystem for Linux (WSL).\n\n## v1.14.2\n\nLivia sas Junius: Echo 2\n\n- Remove default RSS reader rule as it may allow for a targeted attack against rails apps\n [#67](https://github.com/TecharoHQ/anubis/pull/67)\n- Whitelist MojeekBot in botPolicies [#47](https://github.com/TecharoHQ/anubis/issues/47)\n- botPolicies regex has been cleaned up [#66](https://github.com/TecharoHQ/anubis/pull/66)\n\n## v1.14.1\n\nLivia sas Junius: Echo 1\n\n- Set the `X-Real-Ip` header based on the contents of `X-Forwarded-For`\n [#62](https://github.com/TecharoHQ/anubis/issues/62)\n\n## v1.14.0\n\nLivia sas Junius\n\n> Fail to do as my lord commands...and I will spare him the trouble of blocking you.\n\n- Add explanation of what Anubis is doing to the challenge page [#25](https://github.com/TecharoHQ/anubis/issues/25)\n- Administrators can now define artificially hard challenges using the \"slow\" algorithm:\n\n ```json\n {\n \"name\": \"generic-bot-catchall\",\n \"user_agent_regex\": \"(?i:bot|crawler)\",\n \"action\": \"CHALLENGE\",\n \"challenge\": {\n \"difficulty\": 16,\n \"report_as\": 4,\n \"algorithm\": \"slow\"\n }\n }\n ```\n\n This allows administrators to cause particularly malicious clients to use unreasonable amounts of CPU. The UI will also lie to the client about the difficulty.\n\n- Docker images now explicitly call `docker.io/library/<thing>` to increase compatibility with Podman et. al\n [#21](https://github.com/TecharoHQ/anubis/pull/21)\n- Don't overflow the image when browser windows are small (eg. on phones)\n [#27](https://github.com/TecharoHQ/anubis/pull/27)\n- Lower the default difficulty to 5 from 4\n- Don't duplicate work across multiple threads [#36](https://github.com/TecharoHQ/anubis/pull/36)\n- Documentation has been moved to https://anubis.techaro.lol/ with sources in docs/\n- Removed several visible AI artifacts (e.g., 6 fingers) [#37](https://github.com/TecharoHQ/anubis/pull/37)\n- [KagiBot](https://kagi.com/bot) is allowed through the filter [#44](https://github.com/TecharoHQ/anubis/pull/44)\n- Fixed hang when navigator.hardwareConcurrency is undefined\n- Support Unix domain sockets [#45](https://github.com/TecharoHQ/anubis/pull/45)\n- Allow filtering by remote addresses:\n\n ```json\n {\n \"name\": \"qwantbot\",\n \"user_agent_regex\": \"\\\\+https\\\\:\\\\/\\\\/help\\\\.qwant\\\\.com/bot/\",\n \"action\": \"ALLOW\",\n \"remote_addresses\": [\"91.242.162.0/24\"]\n }\n ```\n\n This also works at an IP range level:\n\n ```json\n {\n \"name\": \"internal-network\",\n \"action\": \"ALLOW\",\n \"remote_addresses\": [\"100.64.0.0/10\"]\n }\n ```\n\n## 1.13.0\n\n- Proof-of-work challenges are drastically sped up [#19](https://github.com/TecharoHQ/anubis/pull/19)\n- Docker images are now built with the timestamp set to the commit timestamp\n- The README now points to TecharoHQ/anubis instead of Xe/x\n- Images are built using ko instead of `docker buildx build`\n [#13](https://github.com/TecharoHQ/anubis/pull/13)\n\n## 1.12.1\n\n- Phrasing in the `<noscript>` warning was replaced from its original placeholder text to\n something more suitable for general consumption\n ([fd6903a](https://github.com/TecharoHQ/anubis/commit/fd6903aeed315b8fddee32890d7458a9271e4798)).\n- Footer links on the check page now point to Techaro's brand\n ([4ebccb1](https://github.com/TecharoHQ/anubis/commit/4ebccb197ec20d024328d7f92cad39bbbe4d6359))\n- Anubis was imported from [Xe/x](https://github.com/Xe/x)\n"
},
{
"path": "docs/docs/admin/_category_.json",
"content": "{\n \"label\": \"Administrative guides\",\n \"position\": 40,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Tradeoffs and considerations you may want to keep in mind when using Anubis.\"\n }\n}\n"
},
{
"path": "docs/docs/admin/botstopper.mdx",
"content": "---\ntitle: \"Commercial support and an unbranded version\"\n---\n\nIf you want to use Anubis but organizational policies prevent you from using the branding that the open source project ships, we offer a commercial version of Anubis named BotStopper. BotStopper builds off of the open source core of Anubis and offers organizations more control over the branding, including but not limited to:\n\n- Custom images for different states of the challenge process (in process, success, failure)\n- Custom CSS and fonts\n- Custom titles for the challenge and error pages\n- \"Anubis\" replaced with \"BotStopper\" across the UI\n- A private bug tracker for issues\n\nIn the near future this will expand to:\n\n- A private challenge implementation that does advanced fingerprinting to check if the client is a genuine browser or not\n- Advanced fingerprinting via [Thoth-based advanced checks](./thoth.mdx)\n\nIn order to sign up for BotStopper, please do one of the following:\n\n- Sign up [on GitHub Sponsors](https://github.com/sponsors/Xe) at the $50 per month tier or higher\n- Email [sales@techaro.lol](mailto:sales@techaro.lol) with your requirements for invoicing, please note that custom invoicing will cost more than using GitHub Sponsors for understandable overhead reasons\n\n## Installation\n\nInstall BotStopper like you would Anubis, but replace the image reference. EG:\n\n```diff\n-ghcr.io/techarohq/anubis:latest\n+ghcr.io/techarohq/botstopper/anubis:latest\n```\n\n### Binary packages\n\nBinary packages are available [in the GitHub Releases page](https://github.com/TecharoHQ/botstopper/releases), the main difference is that the package name is `techaro-botstopper`, the systemd service is `techaro-botstopper@your-instance.service`, the binary is `/usr/bin/botstopper`, and the configuration is in `/etc/techaro-botstopper`. All other instructions in the [native package install guide](./native-install.mdx) apply.\n\n### Docker / Podman\n\nIn order to pull the BotStopper image, you need to [authenticate with GitHub's Container Registry](https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry#authenticating-to-the-container-registry).\n\n```text\ndocker login ghcr.io -u your-username --password-stdin\n```\n\nThen you can use the image as normal.\n\n### Kubernetes\n\nIf you are using Kubernetes, you will need to create an image pull secret:\n\n```text\nkubectl create secret docker-registry \\\n techarohq-botstopper \\\n --docker-server ghcr.io \\\n --docker-username any-username \\\n --docker-password <your-access-token> \\\n```\n\nThen attach it to your Deployment:\n\n```diff\n spec:\n securityContext:\n fsGroup: 1000\n+ imagePullSecrets:\n+ - name: techarohq-botstopper\n```\n\n## Configuration\n\n### Docker compose\n\nFollow [the upstream Docker compose directions](https://anubis.techaro.lol/docs/admin/environments/docker-compose) with the following additional options:\n\n```diff\n anubis:\n image: ghcr.io/techarohq/botstopper/anubis:latest\n environment:\n BIND: \":8080\"\n DIFFICULTY: \"4\"\n METRICS_BIND: \":9090\"\n SERVE_ROBOTS_TXT: \"true\"\n TARGET: \"http://nginx\"\n OG_PASSTHROUGH: \"true\"\n OG_EXPIRY_TIME: \"24h\"\n\n+ # botstopper config here\n+ CHALLENGE_TITLE: \"Doing math for your connection!\"\n+ ERROR_TITLE: \"Something went wrong!\"\n+ OVERLAY_FOLDER: /assets\n+ volumes:\n+ - \"./your_folder:/assets\"\n```\n\n#### Example\n\nThere is an example in [docker-compose.yaml](https://github.com/TecharoHQ/botstopper/blob/main/docker-compose.yaml). Start the example with `docker compose up`:\n\n```text\ndocker compose up -d\n```\n\nAnd then open [https://botstopper.local.cetacean.club:8443](https://botstopper.local.cetacean.club:8443) in your browser.\n\n> [!NOTE] \n> This uses locally signed sacrificial TLS certificates stored in `./demo/pki`. Your browser will rightly reject these. Here is what the example looks like:\n>\n> \n\n## Custom images and CSS\n\nAnubis uses an internal filesystem that contains CSS, JavaScript, and images. The BotStopper variant of Anubis lets you specify an overlay folder with the environment variable `OVERLAY_FOLDER`. The contents of this folder will be overlaid on top of Anubis' internal filesystem, allowing you to easily customize the images and CSS.\n\nYour directory tree should look like this, assuming your data is in `./your_folder`:\n\n```text\n./your_folder\n└── static\n ├── css\n │ └── custom.css\n └── img\n ├── happy.webp\n ├── pensive.webp\n └── reject.webp\n```\n\nFor an example directory tree using some off-the-shelf images the Tango icon set, see the [testdata](https://github.com/TecharoHQ/botstopper/tree/main/testdata/static/img) folder.\n\n### Header-based overlay dispatch\n\nIf you run BotStopper in a multi-tenant environment where each tenant needs its own branding, BotStopper supports the ability to use request header values to direct asset reads to different folders under your `OVERLAY_FOLDER`. One of the most common ways to do this is based on the HTTP Host of the request. For example, if you set `ASSET_LOOKUP_HEADER=Host` in BotStopper's environment:\n\n```text\n$OVERLAY_FOLDER\n├── static\n│ ├── css\n│ │ ├── custom.css\n│ │ └── eyesore.css\n│ └── img\n│ ├── happy.webp\n│ ├── pensive.webp\n│ └── reject.webp\n└── test.anubis.techaro.lol\n └── static\n ├── css\n │ └── custom.css\n └── img\n ├── happy.webp\n ├── pensive.webp\n └── reject.webp\n```\n\nRequests to `test.anubis.techaro.lol` will load assets in `$OVERLAY_FOLDER/test.anubis.techaro.lol/static` and all other requests will load them from `$OVERLAY_FOLDER/static`.\n\nFor an example, look at [the testdata folder in the BotStopper repo](https://github.com/TecharoHQ/botstopper/tree/main/testdata).\n\n### Custom CSS\n\nCSS customization is done mainly with CSS variables. View [the example custom CSS file](https://github.com/TecharoHQ/botstopper/blob/main/testdata/static/css/custom.css) for more information about what can be customized.\n\n### Custom fonts\n\nIf you want to add custom fonts, copy the `woff2` files alongside your `custom.css` file and then include them with the [`@font-face` CSS at-rule](https://developer.mozilla.org/en-US/docs/Web/CSS/@font-face):\n\n```css\n@font-face {\n font-family: \"Oswald\";\n font-style: normal;\n font-weight: 200 900;\n font-display: swap;\n src: url(\"./fonts/oswald.woff2\") format(\"woff2\");\n}\n```\n\nThen adjust your CSS variables accordingly:\n\n```css\n:root {\n --body-sans-font: Oswald, sans-serif;\n --body-preformatted-font: monospace;\n --body-title-font: serif;\n}\n```\n\nTo convert `.ttf` fonts to [Web-optimized woff2 fonts](https://www.w3.org/TR/WOFF2/), use the `woff2_compress` command from the `woff2` or `woff2-tools` package:\n\n```console\n$ woff2_compress oswald.ttf\nProcessing oswald.ttf => oswald.woff2\nCompressed 159517 to 70469.\n```\n\nThen you can import and use it as normal.\n\n### Customizing images\n\nAnubis uses three images to visually communicate the state of the program. These are:\n\n| Image name | Intended message | Example |\n| :------------- | :----------------------------------------------- | :-------------------------------- |\n| `happy.webp` | You have passed validation, all is good |  |\n| `pensive.webp` | Checking is running, hold steady until it's done |  |\n| `reject.webp` | Something went wrong, this is a terminal state |  |\n\nTo make your own images at the optimal quality, use the following ffmpeg command:\n\n```text\nffmpeg -i /path/to/image -vf scale=-1:384 happy.webp\n```\n\n`ffprobe` should report something like this on the generated images:\n\n```text\nInput #0, webp_pipe, from 'happy.webp':\n Duration: N/A, bitrate: N/A\n Stream #0:0: Video: webp, none, 25 fps, 25 tbr, 25 tbn\n```\n\nIn testing 384 by 384 pixels gives the best balance between filesize, quality, and clarity.\n\n```text\n$ du -hs *\n4.0K happy.webp\n 12K pensive.webp\n8.0K reject.webp\n```\n\n## Custom HTML templates\n\nIf you need to completely control the HTML layout of all Anubis pages, you can customize the entire page with `USE_TEMPLATES=true`. This uses Go's standard library [html/template](https://pkg.go.dev/html/template) package to template HTML responses. Your templates can contain whatever HTML you want. The only catch is that you MUST include `{{ .Head }}` in the `<head>` element for challenge pages, and you MUST include `{{ .Body }}` in the `<body>` element for all pages.\n\nIn order to use this, you must define the following templates:\n\n| Template path | Usage |\n| :----------------------------------------- | :---------------------------------------------- |\n| `$OVERLAY_FOLDER/templates/challenge.tmpl` | Challenge pages |\n| `$OVERLAY_FOLDER/templates/error.tmpl` | Error pages |\n| `$OVERLAY_FOLDER/templates/impressum.tmpl` | [Impressum](./configuration/impressum.mdx) page |\n\n:::note\n\nCurrently HTML templates don't work together with [Header-based overlay dispatch](#header-based-overlay-dispatch). This is a known issue that will be fixed soon. If you enable header-based overlay dispatch, BotStopper will use the global `templates` folder instead of using the templates present in the overlay.\n\n:::\n\nHere are minimal (but working) examples for each template:\n\n<details>\n<summary>`challenge.tmpl`</summary>\n\n:::note\n\nYou **MUST** include the `{{.Head}}` segment in a `<head>` tag. It contains important information for challenges to execute. If you don't include this, no clients will be able to pass challenges.\n\n:::\n\n```html\n<!DOCTYPE html>\n<html lang=\"{{ .Lang }}\">\n <head>\n {{ .Head }}\n </head>\n <body>\n {{ .Body }}\n </body>\n</html>\n```\n\n</details>\n\n<details>\n<summary>`error.tmpl`</summary>\n\n```html\n<!DOCTYPE html>\n<html lang=\"{{ .Lang }}\">\n <body>\n {{ .Body }}\n </body>\n</html>\n```\n\n</details>\n\n<details>\n<summary>`impressum.tmpl`</summary>\n\n```html\n<!DOCTYPE html>\n<html lang=\"{{ .Lang }}\">\n <body>\n {{ .Body }}\n </body>\n</html>\n```\n\n</details>\n\n### Template functions\n\nIn order to make life easier, the following template functions are defined:\n\n#### `Asset`\n\nConstructs the path for a static asset in the [overlay folder](#custom-images-and-css)'s `static` directory.\n\n```go\nfunc Asset(string) string\n```\n\nUsage:\n\n```html\n<link rel=\"stylesheet\" href=\"{{ Asset \"css/example.css\" }}\" />\n```\n\nGenerates:\n\n```html\n<link\n rel=\"stylesheet\"\n href=\"/.within.website/x/cmd/anubis/static/css/example.css\"\n/>\n```\n\n## Customizing messages\n\nYou can customize messages using the following environment variables:\n\n| Message | Environment variable | Default |\n| :------------------- | :------------------- | :----------------------------------------- |\n| Challenge page title | `CHALLENGE_TITLE` | `Ensuring the security of your connection` |\n| Error page title | `ERROR_TITLE` | `Error` |\n\nFor example:\n\n```sh\n# /etc/techaro-botstopper/gitea.env\nCHALLENGE_TITLE=\"Wait a moment please!\"\nERROR_TITLE=\"Client error\"\n```\n"
},
{
"path": "docs/docs/admin/caveats-gitea-forgejo.mdx",
"content": "---\ntitle: When using Caddy with Gitea/Forgejo\n---\n\nGitea/Forgejo relies on the reverse proxy setting the `X-Real-Ip` header. Caddy does not do this out of the gate. Modify your Caddyfile like this:\n\n```python\nellenjoe.int.within.lgbt {\n # ...\n # diff-remove\n reverse_proxy http://localhost:3000\n # diff-add\n reverse_proxy http://localhost:3000 {\n # diff-add\n header_up X-Real-Ip {remote_host}\n # diff-add\n }\n # ...\n}\n```\n\nEnsure that Gitea/Forgejo have `[security].REVERSE_PROXY_TRUSTED_PROXIES` set to the IP ranges that Anubis will appear from. Typically this is sufficient:\n\n```ini\n[security]\nREVERSE_PROXY_TRUSTED_PROXIES = 127.0.0.0/8,::1/128\n```\n\nHowever if you are running Anubis in a separate Pod/Deployment in Kubernetes, you may have to adjust this to the IP range of the Pod space in your Container Networking Interface plugin:\n\n```ini\n[security]\nREVERSE_PROXY_TRUSTED_PROXIES = 10.192.0.0/12\n```\n"
},
{
"path": "docs/docs/admin/caveats-xff.mdx",
"content": "# Client IP Headers\n\nCurrently Anubis will always flatten the `X-Forwarded-For` when it contains multiple IP addresses. From right to left, the first IP address that is not in one of the following categories will be set as `X-Forwarded-For` in the request passed to the upstream.\n\n- Private (`XFF_STRIP_PRIVATE`, enabled by default)\n- CGNAT (always stripped)\n- Link-local Unicast (always stripped)\n\n```\nIncoming: X-Forwarded-For: 1.2.3.4, 5.6.7.8, 10.0.0.1\nUpstream: X-Forwarded-For: 5.6.7.8\n```\n\nThis behavior will cause problems if the proxy in front of Anubis is from a public IP, such as Cloudflare, because Anubis will use the Cloudflare IP instead of your client's real IP. You will likely see all requests from your browser being blocked and/or an infinite challenge loop.\n\n```\nIncoming: X-Forwarded-For: REAL_CLIENT_IP, CF_IP\nUpstream: X-Forwarded-For: CF_IP\n```\n\nAs a workaround, you should configure your web server to parse an alternative source (such as `CF-Connecting-IP`), or pre-process the incoming `X-Forwarded-For` with your web server to ensure it only contains the real client IP address, then pass it to Anubis as `X-Forwarded-For`.\n\nIf you do not control the web server upstream of Anubis, the `custom-real-ip-header` command line flag accepts a header value that Anubis will read the real client IP address from. Anubis will set the `X-Real-IP` header to the IP address found in the custom header.\n\nThe `X-Real-IP` header will be automatically inferred from `X-Forwarded-For` if not set, setting it explicitly is not necessary as long as `X-Forwarded-For` contains only the real client IP. However setting it explicitly can eliminate spoofed values if your web server doesn't set this.\n\nSee [Cloudflare](environments/cloudflare.mdx) for an example configuration.\n"
},
{
"path": "docs/docs/admin/configuration/_category_.json",
"content": "{\n \"label\": \"Configuration\",\n \"position\": 10,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Detailed information about configuring parts of Anubis.\"\n }\n}\n"
},
{
"path": "docs/docs/admin/configuration/challenges/_category_.json",
"content": "{\n \"label\": \"Challenges\",\n \"position\": 10,\n \"link\": null\n}\n"
},
{
"path": "docs/docs/admin/configuration/challenges/index.mdx",
"content": "# Challenge Methods\n\nAnubis supports multiple challenge methods:\n\n- [Meta Refresh](./metarefresh.mdx)\n- [Preact](./preact.mdx)\n- [Proof of Work](./proof-of-work.mdx)\n\nRead the documentation to know which method is best for you.\n"
},
{
"path": "docs/docs/admin/configuration/challenges/metarefresh.mdx",
"content": "# Meta Refresh (No JavaScript)\n\nThe `metarefresh` challenge sends a browser a much simpler challenge that makes it refresh the page after a set period of time. This enables clients to pass challenges without executing JavaScript.\n\nTo use it in your Anubis configuration:\n\n```yaml\n# Generic catchall rule\n- name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: CHALLENGE\n challenge:\n difficulty: 1 # Number of seconds to wait before refreshing the page\n algorithm: metarefresh # Specify a non-JS challenge method\n```\n\nThis is not enabled by default while this method is tested and its false positive rate is ascertained. Many modern scrapers use headless Google Chrome, so this will have a much higher false positive rate.\n"
},
{
"path": "docs/docs/admin/configuration/challenges/preact.mdx",
"content": "# Preact\n\nThe `preact` challenge sends the browser a simple challenge that makes it run very lightweight JavaScript that proves the client is able to execute client-side JavaScript. It uses [Preact](https://www.npmjs.com/package/preact) (a lightweight client side web framework in the vein of React) to do this.\n\nTo use it in your Anubis configuration:\n\n```yaml\n# Generic catchall rule\n- name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: CHALLENGE\n challenge:\n difficulty: 1 # Number of seconds to wait before refreshing the page\n algorithm: preact\n```\n\nThis is the default challenge method for most clients.\n"
},
{
"path": "docs/docs/admin/configuration/challenges/proof-of-work.mdx",
"content": "# Proof of Work (JavaScript)\n\nWhen Anubis is configured to use the `fast` or `slow` challenge methods, clients will be sent a small [proof of work](https://en.wikipedia.org/wiki/Proof_of_work) challenge. In order to get a token used to access the upstream resource, clients must calculate a complicated math puzzle with JavaScript.\n\nA `fast` challenge uses a heavily optimized multithreaded implementation and a `slow` challenge uses a simplistic single-threaded implementation. The `slow` method is kept around for legacy compatibility.\n"
},
{
"path": "docs/docs/admin/configuration/custom-status-codes.mdx",
"content": "# Custom status codes for Anubis errors\n\nOut of the box, Anubis will reply with `HTTP 200` for challenge and denial pages. This is intended to make AI scrapers have a hard time with your website because when they are faced with a non-200 response, they will hammer the page over and over until they get a 200 response. This behavior may not be desirable, as such Anubis lets you customize what HTTP status codes are returned when Anubis throws challenge and denial pages.\n\nThis is configured in the `status_codes` block of your [bot policy file](../policies.mdx):\n\n```yaml\nstatus_codes:\n CHALLENGE: 200\n DENY: 200\n```\n\nTo match CloudFlare's behavior, use a configuration like this:\n\n```yaml\nstatus_codes:\n CHALLENGE: 403\n DENY: 403\n```\n"
},
{
"path": "docs/docs/admin/configuration/expressions.mdx",
"content": "# Expression-based rule matching\n\nMost of the Anubis matchers let you match individual parts of a request and only those parts in isolation. In order to defend a service in depth, you often need the ability to match against multiple aspects of a request. Anubis implements [Common Expression Language (CEL)](https://cel.dev) to let administrators define these more advanced rules. This allows you to tailor your approach for the individual services you are protecting.\n\nAs an example, here is a rule that lets you allow JSON API requests through Anubis:\n\n```yaml\n- name: allow-api-requests\n action: ALLOW\n expression:\n all:\n - '\"Accept\" in headers'\n - 'headers[\"Accept\"] == \"application/json\"'\n - 'path.startsWith(\"/api/\")'\n```\n\nThis is an advanced feature and as such it is easy to get yourself in trouble with it. Use this with care.\n\n## Common Expression Language (CEL)\n\nCEL is an expression language made by Google as a part of their access control lists system. As programs grow more complicated and users have the need to express more complicated security requirements, they often want the ability to just run a small bit of code to check things for themselves. CEL expressions are built for this. They are implicitly sandboxed so that they cannot affect the system they are running in and also designed to evaluate as fast as humanly possible.\n\nImagine a CEL expression as the contents of an `if` statement in JavaScript or the `WHERE` clause in SQL. Consider this example expression:\n\n```python\nuserAgent == \"\"\n```\n\nThis is roughly equivalent to the following in JavaScript:\n\n```js\nif (userAgent == \"\") {\n // Do something\n}\n```\n\nUsing these expressions, you can define more elaborate rules as facts and circumstances demand. For more information about the syntax and grammar of CEL, take a look at [the language specification](https://github.com/google/cel-spec/blob/master/doc/langdef.md).\n\n## How Anubis uses CEL\n\nAnubis uses CEL to let administrators create complicated filter rules. Anubis has several modes of using CEL:\n\n- Validating requests against single expressions\n- Validating multiple expressions and ensuring at least one of them are true (`any`)\n- Validating multiple expressions and ensuring all of them are true (`all`)\n\nThe common pattern is that every Anubis expression returns `true`, `false`, or raises an error.\n\n### Single expressions\n\nA single expression that returns either `true` or `false`. If the expression returns `true`, then the action specified in the rule will be taken. If it returns `false`, Anubis will move on to the next rule.\n\nFor example, consider this rule:\n\n```yaml\n- name: no-user-agent-string\n action: DENY\n expression: userAgent == \"\"\n```\n\nFor this rule, if a request comes in without a [`User-Agent` string](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/User-Agent) set, Anubis will deny the request and return an error page.\n\n### `any` blocks\n\nAn `any` block that contains a list of expressions. If any expression in the list returns `true`, then the action specified in the rule will be taken. If all expressions in that list return `false`, Anubis will move on to the next rule.\n\nFor example, consider this rule:\n\n```yaml\n- name: known-banned-user\n action: DENY\n expression:\n any:\n - remoteAddress == \"8.8.8.8\"\n - remoteAddress == \"1.1.1.1\"\n```\n\nFor this rule, if a request comes in from `8.8.8.8` or `1.1.1.1`, Anubis will deny the request and return an error page.\n\n### `all` blocks\n\nAn `all` block that contains a list of expressions. If all expressions in the list return `true`, then the action specified in the rule will be taken. If any of the expressions in the list returns `false`, Anubis will move on to the next rule.\n\nFor example, consider this rule:\n\n```yaml\n- name: go-get\n action: ALLOW\n expression:\n all:\n - userAgent.startsWith(\"Go-http-client/\")\n - '\"go-get\" in query'\n - query[\"go-get\"] == \"1\"\n```\n\nFor this rule, if a request comes in matching [the signature of the `go get` command](https://pkg.go.dev/cmd/go#hdr-Remote_import_paths), Anubis will allow it through to the target.\n\n## Variables exposed to Anubis expressions\n\nAnubis exposes the following variables to expressions:\n\n| Name | Type | Explanation | Example |\n| :-------------- | :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------- |\n| `headers` | `map[string, string]` | The [headers](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers) of the request being processed. | `{\"User-Agent\": \"Mozilla/5.0 Gecko/20100101 Firefox/137.0\"}` |\n| `host` | `string` | The [HTTP hostname](https://web.dev/articles/url-parts#host) the request is targeted to. | `anubis.techaro.lol` |\n| `contentLength` | `int64` | The numerical value of the `Content-Length` header. |\n| `load_1m` | `double` | The current system load average over the last one minute. This is useful for making [load-based checks](#using-the-system-load-average). |\n| `load_5m` | `double` | The current system load average over the last five minutes. This is useful for making [load-based checks](#using-the-system-load-average). |\n| `load_15m` | `double` | The current system load average over the last fifteen minutes. This is useful for making [load-based checks](#using-the-system-load-average). |\n| `method` | `string` | The [HTTP method](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Methods) in the request being processed. | `GET`, `POST`, `DELETE`, etc. |\n| `path` | `string` | The [path](https://web.dev/articles/url-parts#pathname) of the request being processed. | `/`, `/api/memes/create` |\n| `query` | `map[string, string]` | The [query parameters](https://web.dev/articles/url-parts#query) of the request being processed. | `?foo=bar` -> `{\"foo\": \"bar\"}` |\n| `remoteAddress` | `string` | The IP address of the client. | `1.1.1.1` |\n| `userAgent` | `string` | The [`User-Agent`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/User-Agent) string in the request being processed. | `Mozilla/5.0 Gecko/20100101 Firefox/137.0` |\n\nOf note: in many languages when you look up a key in a map and there is nothing there, the language will return some \"falsy\" value like `undefined` in JavaScript, `None` in Python, or the zero value of the type in Go. In CEL, if you try to look up a value that does not exist, execution of the expression will fail and Anubis will return an error.\n\nIn order to avoid this, make sure the header or query parameter you are testing is present in the request with an `all` block like this:\n\n```yaml\n- name: challenge-wiki-history-page\n action: CHALLENGE\n all:\n - 'path == \"/index.php\"'\n - '\"title\" in query'\n - '\"action\" in query'\n - 'query[\"action\"] == \"history\"'\n```\n\nThis rule throws a challenge if and only if all of the following conditions are true:\n\n- The URL path is `/index.php`\n- The URL query string contains a `title` value\n- The URL query string contains an `action` value\n- The URL query string's `action` value is `\"history\"`\n\nSo given an HTTP request like this:\n\n```text\nGET /index.php?title=Index&action=history HTTP/1.1\nUser-Agent: Mozilla/5.0 Gecko/20100101 Firefox/137.0\nHost: wiki.int.techaro.lol\nX-Real-Ip: 8.8.8.8\n```\n\nAnubis would return a challenge because all of those conditions are true.\n\n### Using the system load average\n\nIn Unix-like systems (such as Linux), every process on the system has to wait its turn to be able to run. This means that as more processes on the system are running, they need to wait longer to be able to execute. The [load average](<https://en.wikipedia.org/wiki/Load_(computing)>) represents the number of processes that want to be able to run but can't run yet. This metric isn't the most reliable to identify a cause, but is great at helping to identify symptoms.\n\nAnubis lets you use the system load average as an input to expressions so that you can make dynamic rules like \"when the system is under a low amount of load, dial back the protection, but when it's under a lot of load, crank it up to the mix\". This lets you get all of the blocking features of Anubis in the background but only really expose Anubis to users when the system is actively being attacked.\n\nThis is best combined with the [weight](../policies.mdx#request-weight) and [threshold](./thresholds.mdx) systems so that you can have Anubis dynamically respond to attacks. Consider these rules in the default configuration file:\n\n```yaml\n## System load based checks.\n# If the system is under high load for the last minute, add weight.\n- name: high-load-average\n action: WEIGH\n expression: load_1m >= 10.0 # make sure to end the load comparison in a .0\n weight:\n adjust: 20\n\n# If it is not for the last 15 minutes, remove weight.\n- name: low-load-average\n action: WEIGH\n expression: load_15m <= 4.0 # make sure to end the load comparison in a .0\n weight:\n adjust: -10\n```\n\nThis combination of rules makes Anubis dynamically react to the system load and only kick in when the system is under attack.\n\nSomething to keep in mind about system load average is that it is not aware of the number of cores the system has. If you have a 16 core system that has 16 processes running but none of them is hogging the CPU, then you will get a load average below 16. If you are in doubt, make your \"high load\" metric at least two times the number of CPU cores and your \"low load\" metric at least half of the number of CPU cores. For example:\n\n| Kind | Core count | Load threshold |\n| --------: | :--------- | :------------- |\n| high load | 4 | `8.0` |\n| low load | 4 | `2.0` |\n| high load | 16 | `32.0` |\n| low load | 16 | `8` |\n\nAlso keep in mind that this does not account for other kinds of latency like I/O latency. A system can have its web applications unresponsive due to high latency from a MySQL server but still have that web application server report a load near or at zero.\n\n## Functions exposed to Anubis expressions\n\nAnubis expressions can be augmented with the following functions:\n\n### `missingHeader`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction missingHeader(headers: Record<string, string>, key: string) bool\n```\n\n`missingHeader` returns `true` if the request does not contain a header. This is useful when you are trying to assert behavior such as:\n\n```yaml\n# Adds weight to old versions of Chrome\n- name: old-chrome\n action: WEIGH\n weight:\n adjust: 10\n expression:\n all:\n - userAgent.matches(\"Chrome/[1-9][0-9]?\\\\.0\\\\.0\\\\.0\")\n - missingHeader(headers, \"Sec-Ch-Ua\")\n```\n\n### `randInt`\n\nAvailable in all expressions.\n\n```ts\nfunction randInt(n: int): int;\n```\n\nrandInt returns a randomly selected integer value in the range of `[0,n)`. This is a thin wrapper around [Go's math/rand#Intn](https://pkg.go.dev/math/rand#Intn). Be careful with this as it may cause inconsistent behavior for genuine users.\n\nThis is best applied when doing explicit block rules, eg:\n\n```yaml\n# Denies LightPanda about 75% of the time on average\n- name: deny-lightpanda-sometimes\n action: DENY\n expression:\n all:\n - userAgent.matches(\"LightPanda\")\n - randInt(16) >= 4\n```\n\nIt seems counter-intuitive to allow known bad clients through sometimes, but this allows you to confuse attackers by making Anubis' behavior random. Adjust the thresholds and numbers as facts and circumstances demand.\n\n### `regexSafe`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction regexSafe(input: string): string;\n```\n\n`regexSafe` takes a string and escapes it for safe use inside of a regular expression. This is useful when you are creating regular expressions from headers or variables such as `remoteAddress`.\n\n| Input | Output |\n| :------------------------- | :-------------- |\n| `regexSafe(\"1.2.3.4\")` | `1\\\\.2\\\\.3\\\\.4` |\n| `regexSafe(\"techaro.lol\")` | `techaro\\\\.lol` |\n| `regexSafe(\"star*\")` | `star\\\\*` |\n| `regexSafe(\"plus+\")` | `plus\\\\+` |\n| `regexSafe(\"{braces}\")` | `\\\\{braces\\\\}` |\n| `regexSafe(\"start^\")` | `start\\\\^` |\n| `regexSafe(\"back\\\\slash\")` | `back\\\\\\\\slash` |\n| `regexSafe(\"dash-dash\")` | `dash\\\\-dash` |\n\n### `segments`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction segments(path: string): string[];\n```\n\n`segments` returns the number of slash-separated path segments, ignoring the leading slash. Here is what it will return with some common paths:\n\n| Input | Output |\n| :----------------------- | :--------------------- |\n| `segments(\"/\")` | `[\"\"]` |\n| `segments(\"/foo/bar\")` | `[\"foo\", \"bar\"] ` |\n| `segments(\"/users/xe/\")` | `[\"users\", \"xe\", \"\"] ` |\n\n:::note\n\nIf the path ends with a `/`, then the last element of the result will be an empty string. This is because `/users/xe` and `/users/xe/` are semantically different paths.\n\n:::\n\nThis is useful if you want to write rules that allow requests that have no query parameters only if they have less than two path segments:\n\n```yaml\n- name: two-path-segments-no-query\n action: ALLOW\n expression:\n all:\n - size(query) == 0\n - size(segments(path)) < 2\n```\n\n### DNS Functions\n\nAnubis can also perform DNS lookups as a part of its expression evaluation. This can be useful for doing things like checking for a valid [Forward-confirmed reverse DNS (FCrDNS)](https://en.wikipedia.org/wiki/Forward-confirmed_reverse_DNS) record.\n\n#### `arpaReverseIP`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction arpaReverseIP(ip: string): string;\n```\n\n`arpaReverseIP` takes an IP address and returns its value in [ARPA notation](https://www.ietf.org/rfc/rfc2317.html). This can be useful when matching PTR record patterns.\n\n| Input | Output |\n| :----------------------------- | :---------------------------------------------------------------- |\n| `arpaReverseIP(\"1.2.3.4\")` | `4.3.2.1` |\n| `arpaReverseIP(\"2001:db8::1\")` | `1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2` |\n\n#### `lookupHost`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction lookupHost(host: string): string[];\n```\n\n`lookupHost` performs a DNS lookup for the given hostname and returns a list of IP addresses.\n\n```yaml\n- name: cloudflare-ip-in-host-header\n action: DENY\n expression: '\"104.16.0.0\" in lookupHost(headers[\"Host\"])'\n```\n\n#### `reverseDNS`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction reverseDNS(ip: string): string[];\n```\n\n`reverseDNS` takes an IP address and returns the DNS names associated with it. This is useful when you want to check PTR records of an IP address.\n\n```yaml\n- name: allow-googlebot\n action: ALLOW\n expression: 'reverseDNS(remoteAddress).endsWith(\".googlebot.com\")'\n```\n\n::: warning\n\nDo not use this for validating the legitimacy of an IP address. It is possible for DNS records to be out of date or otherwise manipulated. Use [`verifyFCrDNS`](#verifyfcrdns) instead for a more reliable result.\n\n:::\n\n#### `verifyFCrDNS`\n\nAvailable in `bot` expressions.\n\n```ts\nfunction verifyFCrDNS(ip: string): bool;\nfunction verifyFCrDNS(ip: string, pattern: string): bool;\n```\n\n`verifyFCrDNS` checks if the reverse DNS of an IP address matches its forward DNS. This is a common technique to filter out spam and bot traffic. `verifyFCrDNS` comes in two forms:\n\n- `verifyFCrDNS(remoteAddress)` will check that the reverse DNS of the remote address resolves back to the remote address. If no PTR records, returns true.\n- `verifyFCrDNS(remoteAddress, pattern)` will check that the reverse DNS of the remote address is matching with pattern and that name resolves back to the remote address.\n\nThis is best used in rules like this:\n\n```yaml\n- name: require-fcrdns-for-post\n action: DENY\n expression:\n all:\n - method == \"POST\"\n - \"!verifyFCrDNS(remoteAddress)\"\n```\n\nHere is an another example that allows requests from telegram:\n\n```yaml\n- name: telegrambot\n action: ALLOW\n expression:\n all:\n - userAgent.matches(\"TelegramBot\")\n - verifyFCrDNS(remoteAddress, \"ptr\\\\.telegram\\\\.org$\")\n```\n\n## Life advice\n\nExpressions are very powerful. This is a benefit and a burden. If you are not careful with your expression targeting, you will be liable to get yourself into trouble. If you are at all in doubt, throw a `CHALLENGE` over a `DENY`. Legitimate users can easily work around a `CHALLENGE` result with a [proof of work challenge](../../design/why-proof-of-work.mdx). Bots are less likely to be able to do this.\n"
},
{
"path": "docs/docs/admin/configuration/import.mdx",
"content": "# Importing configuration rules\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\nAnubis has the ability to let you import snippets of configuration into the main configuration file. This allows you to break up your config into smaller parts that get logically assembled into one big file.\n\nEG:\n\n```yaml\nbots:\n # Pathological bots to deny\n - # This correlates to data/bots/ai-catchall.yaml in the source tree\n import: (data)/bots/ai-catchall.yaml\n - import: (data)/bots/cloudflare-workers.yaml\n # Import all the rules in the default configuration\n - import: (data)/meta/default-config.yaml\n```\n\nOf note, a bot rule can either have inline bot configuration or import a bot config snippet. You cannot do both in a single bot rule.\n\n```yaml\nbots:\n - import: (data)/bots/ai-catchall.yaml\n name: generic-browser\n user_agent_regex: >\n Mozilla|Opera\n action: CHALLENGE\n```\n\nThis will return an error like this:\n\n```text\nconfig is not valid:\nconfig.BotOrImport: rule definition is invalid, you must set either bot rules or an import statement, not both\n```\n\nPaths can either be prefixed with `(data)` to import from the [the data folder in the Anubis source tree](https://github.com/TecharoHQ/anubis/tree/main/data) or anywhere on the filesystem. If you don't have access to the Anubis source tree, check /usr/share/docs/anubis/data or in the tarball you extracted Anubis from.\n\n## Importing the default configuration\n\nIf you want to base your configuration off of the default configuration, import `(data)/meta/default-config.yaml`:\n\n```yaml\nbots:\n - import: (data)/meta/default-config.yaml\n # Write your rules here\n```\n\nThis will keep your configuration up to date as Anubis adapts to emerging threats.\n\n## How do I exempt most modern browsers from Anubis challenges?\n\nIf you want to exempt most modern browsers from Anubis challenges, import `(data)/common/acts-like-browser.yaml`:\n\n```yaml\nbots:\n - import: (data)/meta/default-config.yaml\n - import: (data)/common/acts-like-browser.yaml\n # Write your rules here\n```\n\nThese rules will allow traffic that \"looks like\" it's from a modern copy of Edge, Safari, Chrome, or Firefox. These rules used to be enabled by default, however user reports have suggested that AI scraper bots have adapted to conform to these rules to scrape without regard for the infrastructure they are attacking.\n\nUse these rules at your own risk.\n\n## Importing from imports\n\nYou can also import from an imported file in case you want to import an entire folder of rules at once.\n\n```yaml\nbots:\n - import: (data)/bots/_deny-pathological.yaml\n```\n\nThis lets you import an entire ruleset at once:\n\n```yaml\n# (data)/bots/_deny-pathological.yaml\n- import: (data)/bots/cloudflare-workers.yaml\n- import: (data)/bots/headless-browsers.yaml\n- import: (data)/bots/us-ai-scraper.yaml\n```\n\nUse this with care, you can easily get yourself into a state where Anubis recursively imports things for eternity if you are not careful. The best way to use this is to make a \"root import\" named `_everything.yaml` or `_allow-good.yaml` so they sort to the top. Name your meta-imports after the main verb they are enforcing so that you can glance at the configuration file and understand what it's doing.\n\n## Writing snippets\n\nSnippets can be written in either JSON or YAML, with a preference for YAML. When writing a snippet, write the bot rules you want directly at the top level of the file in a list.\n\nHere is an example snippet that allows [IPv6 Unique Local Addresses](https://en.wikipedia.org/wiki/Unique_local_address) through Anubis:\n\n```yaml\n- name: ipv6-ula\n action: ALLOW\n remote_addresses:\n - fc00::/7\n```\n\n## Extracting Anubis' embedded filesystem\n\nYou can always extract the list of rules embedded into the Anubis binary with this command:\n\n```text\nanubis --extract-resources=static\n```\n\nThis will dump the contents of Anubis' embedded data to a new folder named `static`:\n\n```text\nstatic\n├── apps\n│ └── gitea-rss-feeds.yaml\n├── botPolicies.json\n├── botPolicies.yaml\n├── bots\n│ ├── ai-catchall.yaml\n│ ├── cloudflare-workers.yaml\n│ ├── headless-browsers.yaml\n│ └── us-ai-scraper.yaml\n├── common\n│ ├── allow-private-addresses.yaml\n│ └── keep-internet-working.yaml\n└── crawlers\n ├── bingbot.yaml\n ├── duckduckbot.yaml\n ├── googlebot.yaml\n ├── internet-archive.yaml\n ├── kagibot.yaml\n ├── marginalia.yaml\n ├── mojeekbot.yaml\n └── qwantbot.yaml\n```\n"
},
{
"path": "docs/docs/admin/configuration/impressum.mdx",
"content": "# Imprint / Impressum configuration\n\nSome jurisdictions (such as the European Union and specifically Germany) [must have contact information freely available](https://www.privacycompany.eu/blog/the-imprint-requirement-a-must-have-for-companies-from-outside-germany) on an imprint/impressum page. Anubis supports creating an Anubis-specific imprint page for your organization with the `impressum` block in your bot policy file. For example:\n\n```yaml\nimpressum:\n # Displayed at the bottom of every page rendered by Anubis.\n footer: >-\n This website is hosted by Techaro. If you have any complaints or notes \n about the service, please contact\n <a href=\"mailto:contact@techaro.lol\">contact@techaro.lol</a> and we\n will assist you as soon as possible.\n\n # The imprint page that will be linked to at the footer of every Anubis page.\n page:\n # The HTML <title> of the page\n title: Imprint and Privacy Policy\n # The HTML contents of the page. The exact contents of this page can\n # and will vary by locale. Please consult with a lawyer if you are not\n # sure what to put here\n body: >-\n <p>Last updated: June 2025</p>\n\n <h2>Information that is gathered from visitors</h2>\n\n <p>In common with other websites, log files are stored on the web server saving details such as the visitor's IP address, browser type, referring page and time of visit.</p>\n\n <p>Cookies may be used to remember visitor preferences when interacting with the website.</p>\n\n <p>Where registration is required, the visitor's email and a username will be stored on the server.</p>\n\n <!-- ... -->\n```\n\nIf you are subscribed to and using [advanced classification features](../thoth.mdx), be sure to disclose the following:\n\n```html\n<h2>Techaro Anubis</h2>\n\n<p>\n This website uses a service called\n <a href=\"https://anubis.techaro.lol\">Anubis</a> by\n <a href=\"https://techaro.lol\">Techaro</a> to filter malicious traffic. Anubis\n requires the use of browser cookies to ensure that web clients are running\n conformant software. Anubis also may report the following data to Techaro to\n improve service quality:\n</p>\n\n<ul>\n <li>\n IP address (for purposes of matching against geo-location and BGP autonomous\n systems numbers), which is stored in-memory and not persisted to disk.\n </li>\n <li>\n Unique browser fingerprints (such as HTTP request fingerprints and\n encryption system fingerprints), which may be stored on Techaro's side for a\n period of up to one month.\n </li>\n <li>\n HTTP request metadata that may include things such as the User-Agent header\n and other identifiers.\n </li>\n</ul>\n\n<p>\n This data is processed and stored for the legitimate interest of combatting\n abusive web clients. This data is encrypted at rest as much as possible and is\n only decrypted in memory for the purposes of fulfilling requests.\n</p>\n```\n"
},
{
"path": "docs/docs/admin/configuration/open-graph.mdx",
"content": "---\nid: open-graph\ntitle: Open Graph Configuration\n---\n\n# Open Graph Configuration\n\nThis page provides detailed information on how to configure [Open Graph tag](https://ogp.me/) passthrough in Anubis. This enables social previews of resources protected by Anubis without having to exempt each scraper individually.\n\n## Configuration Options\n\nOpen Graph settings are configured in the `openGraph` section of the [Policy File](../policies.mdx).\n\n```yaml\nopenGraph:\n # Enables Open Graph passthrough\n enabled: true\n # Enables the use of the HTTP host in the cache key, this enables\n # caching metadata for multiple http hosts at once.\n considerHost: true\n # How long cached OpenGraph metadata should last in memory\n ttl: 24h\n # If set, return these opengraph values instead of looking them up with\n # the target service.\n #\n # Correlates to properties in https://ogp.me/\n override:\n # og:title is required, it is the title of the website\n \"og:title\": \"Techaro Anubis\"\n \"og:description\": >-\n Anubis is a Web AI Firewall Utility that helps you fight the bots\n away so that you can maintain uptime at work!\n \"description\": >-\n Anubis is a Web AI Firewall Utility that helps you fight the bots\n away so that you can maintain uptime at work!\n```\n\n<details>\n<summary>Configuration flags / envvars (old)</summary>\n\nOpen Graph passthrough used to be configured with configuration flags / environment variables. Reference to these settings are maintained for backwards compatibility's sake.\n\n| Name | Description | Type | Default | Example |\n| ------------------------ | --------------------------------------------------------- | -------- | ------- | ----------------------------- |\n| `OG_PASSTHROUGH` | Enables or disables the Open Graph tag passthrough system | Boolean | `true` | `OG_PASSTHROUGH=true` |\n| `OG_EXPIRY_TIME` | Configurable cache expiration time for Open Graph tags | Duration | `24h` | `OG_EXPIRY_TIME=1h` |\n| `OG_CACHE_CONSIDER_HOST` | Enables or disables the use of the host in the cache key | Boolean | `false` | `OG_CACHE_CONSIDER_HOST=true` |\n\n</details>\n\n## Usage\n\nTo configure Open Graph tags, you can set the following environment variables, environment file or as flags in your Anubis configuration:\n\n```sh\nexport OG_PASSTHROUGH=true\nexport OG_EXPIRY_TIME=1h\nexport OG_CACHE_CONSIDER_HOST=false\n```\n\n## Implementation Details\n\nWhen `OG_PASSTHROUGH` is enabled, Anubis will:\n\n1. Check a local cache for the requested URL's Open Graph tags.\n2. If a cached entry exists and is still valid, return the cached tags.\n3. If the cached entry is stale or not found, fetch the URL, parse the Open Graph tags, update the cache, and return the new tags.\n\nThe cache expiration time is controlled by `OG_EXPIRY_TIME`.\n\nWhen `OG_CACHE_CONSIDER_HOST` is enabled, Anubis will include the host in the cache key for Open Graph tags. This ensures that tags are cached separately for different hosts.\n\n## Example\n\nHere is an example of how to configure Open Graph tags in your Anubis setup:\n\n```sh\nexport OG_PASSTHROUGH=true\nexport OG_EXPIRY_TIME=1h\nexport OG_CACHE_CONSIDER_HOST=false\n```\n\nWith these settings, Anubis will cache Open Graph tags for 1 hour and pass them through to the challenge page, not considering the host in the cache key.\n\n## When to Enable `OG_CACHE_CONSIDER_HOST`\n\nIn most cases, you would want to keep `OG_CACHE_CONSIDER_HOST` set to `false` to avoid unnecessary cache fragmentation. However, there are some scenarios where enabling this option can be beneficial:\n\n1. **Multi-Tenant Applications**: If you are running a multi-tenant application where different tenants are hosted on different subdomains, enabling `OG_CACHE_CONSIDER_HOST` ensures that the Open Graph tags are cached separately for each tenant. This prevents one tenant's Open Graph tags from being served to another tenant's users.\n\n2. **Different Content for Different Hosts**: If your application serves different content based on the host, enabling `OG_CACHE_CONSIDER_HOST` ensures that the correct Open Graph tags are cached and served for each host. This is useful for applications that have different branding or content for different domains or subdomains.\n\n3. **Security and Privacy Concerns**: In some cases, you may want to ensure that Open Graph tags are not shared between different hosts for security or privacy reasons. Enabling `OG_CACHE_CONSIDER_HOST` ensures that the tags are cached separately for each host, preventing any potential leakage of information between hosts.\n\nFor more information, refer to the [installation guide](../installation).\n"
},
{
"path": "docs/docs/admin/configuration/redirect-domains.mdx",
"content": "---\ntitle: Redirect Domain Configuration\n---\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\nAnubis has an HTTP redirect in the middle of its check validation logic. This redirect allows Anubis to set a cookie on validated requests so that users don't need to pass challenges on every page load.\n\nThis flow looks something like this:\n\n```mermaid\nsequenceDiagram\n participant User\n participant Challenge\n participant Validation\n participant Backend\n\n User->>+Challenge: GET /\n Challenge->>+User: Solve this challenge\n User->>+Validation: Here's the solution, send me to /\n Validation->>+User: Here's a cookie, go to /\n User->>+Backend: GET /\n```\n\nHowever, in some cases a sufficiently dedicated attacker could trick a user into clicking on a validation link with a solution pre-filled out. For example:\n\n```mermaid\nsequenceDiagram\n participant Hacker\n participant User\n participant Validation\n participant Evil Site\n\n Hacker->>+User: Click on example.org with this solution\n User->>+Validation: Here's a solution, send me to evilsite.com\n Validation->>+User: Here's a cookie, go to evilsite.com\n User->>+Evil Site: GET evilsite.com\n```\n\nIf this happens, Anubis will throw an error like this:\n\n```text\nRedirect domain not allowed\n```\n\n## Configuring allowed redirect domains\n\nBy default, Anubis may redirect to any domain which could cause security issues in the unlikely case that an attacker passes a challenge for your browser and then tricks you into clicking a link to your domain.\nOne can restrict the domains that Anubis can redirect to when passing a challenge by setting up `REDIRECT_DOMAINS` environment variable.\nIf you need to set more than one domain, fill the environment variable with a comma-separated list of domain names.\nThere is also glob matching support. You can pass `*.bugs.techaro.lol` to allow redirecting to anything ending with `.bugs.techaro.lol`. There is a limit of 4 wildcards.\n\n:::note\n\nIf you are hosting Anubis on a non-standard port (`https://example:com:8443`, `http://www.example.net:8080`, etc.), you must also include the port number here.\n\n:::\n\n<Tabs>\n <TabItem value=\"env-file\" label=\"Environment file\" default>\n\n```shell\n# anubis.env\n\nREDIRECT_DOMAINS=\"example.org,secretplans.example.org,*.test.example.org\"\n# ...\n```\n\n </TabItem>\n <TabItem value=\"docker-compose\" label=\"Docker Compose\">\n\n```yaml\nservices:\n anubis-nginx:\n image: ghcr.io/techarohq/anubis:latest\n environment:\n REDIRECT_DOMAINS: \"example.org,secretplans.example.org,*.test.example.org\"\n # ...\n```\n\n </TabItem>\n <TabItem value=\"k8s\" label=\"Kubernetes\">\n\nInside your Deployment, StatefulSet, or Pod:\n\n```yaml\n- name: anubis\n image: ghcr.io/techarohq/anubis:latest\n env:\n - name: REDIRECT_DOMAINS\n value: \"example.org,secretplans.example.org,*.test.example.org\"\n # ...\n```\n\n </TabItem>\n</Tabs>\n"
},
{
"path": "docs/docs/admin/configuration/subrequest-auth.mdx",
"content": "---\ntitle: Subrequest Authentication\n---\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\nAnubis can act in one of two modes:\n\n1. Reverse proxy (the default): Anubis sits in the middle of all traffic and then will reverse proxy it to its destination. This is the moral equivalent of a middleware in your favorite web framework.\n2. Subrequest authentication mode: Anubis listens for requests and if they don't pass muster then they are forwarded to Anubis for challenge processing. This is the equivalent of Anubis being a sidecar service.\n\n:::note\n\nSubrequest authentication requires changing the default policy because nginx interprets the default `DENY` status code `200` as successful authentication and allows the request.\n\n```yaml\nstatus_codes:\n CHALLENGE: 200\n DENY: 403\n```\n\n[See policy definitions](../policies.mdx).\n\n:::\n\n## Nginx\n\nAnubis can perform [subrequest authentication](https://docs.nginx.com/nginx/admin-guide/security-controls/configuring-subrequest-authentication/) with the `auth_request` module in Nginx. In order to set this up, keep the following things in mind:\n\nThe `TARGET` environment variable in Anubis must be set to a space, eg:\n\n<Tabs>\n <TabItem value=\"env-file\" label=\"Environment file\" default>\n\n```shell\n# anubis.env\n\nTARGET=\" \"\n# ...\n```\n\n </TabItem>\n <TabItem value=\"docker-compose\" label=\"Docker Compose\">\n\n```yaml\nservices:\n anubis-nginx:\n image: ghcr.io/techarohq/anubis:latest\n environment:\n TARGET: \" \"\n # ...\n```\n\n </TabItem>\n <TabItem value=\"k8s\" label=\"Kubernetes\">\n\nInside your Deployment, StatefulSet, or Pod:\n\n```yaml\n- name: anubis\n image: ghcr.io/techarohq/anubis:latest\n env:\n - name: TARGET\n value: \" \"\n # ...\n```\n\n </TabItem>\n</Tabs>\n\nIn order to configure this, you need to add the following location blocks to each server pointing to the service you want to protect:\n\n```nginx\nlocation /.within.website/ {\n # Assumption: Anubis is running in the same network namespace as\n # nginx on localhost TCP port 8923\n proxy_pass http://127.0.0.1:8923;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n proxy_set_header Host $http_host;\n proxy_pass_request_body off;\n proxy_set_header content-length \"\";\n auth_request off;\n}\n\nlocation @redirectToAnubis {\n return 307 /.within.website/?redir=$scheme://$host$request_uri;\n auth_request off;\n}\n```\n\nThis sets up `/.within.website` to point to Anubis. Any requests that Anubis rejects or throws a challenge to will be sent here. This also sets up a named location `@redirectToAnubis` that will redirect any requests to Anubis for advanced processing.\n\nFinally, add this to your root location block:\n\n```nginx\nlocation / {\n # diff-add\n auth_request /.within.website/x/cmd/anubis/api/check;\n # diff-add\n error_page 401 = @redirectToAnubis;\n}\n```\n\nThis will check all requests that don't match other locations with Anubis to ensure the client is genuine.\n\nThis will make every request get checked by Anubis before it hits your backend. If you have other locations that don't need Anubis to do validation, add the `auth_request off` directive to their blocks:\n\n```nginx\nlocation /secret {\n # diff-add\n auth_request off;\n\n # ...\n}\n```\n\nHere is a complete example of an Nginx server listening over TLS and pointing to Anubis:\n\n<details>\n <summary>Complete example</summary>\n\n```nginx\n# /etc/nginx/conf.d/nginx.local.cetacean.club.conf\n\nserver {\n listen 443 ssl;\n listen [::]:443 ssl;\n server_name nginx.local.cetacean.club;\n ssl_certificate /etc/techaro/pki/nginx.local.cetacean.club/tls.crt;\n ssl_certificate_key /etc/techaro/pki/nginx.local.cetacean.club/tls.key;\n ssl_protocols TLSv1.2 TLSv1.3;\n ssl_ciphers HIGH:!aNULL:!MD5;\n\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;\n\n location /.within.website/ {\n proxy_pass http://localhost:8923;\n auth_request off;\n }\n\n location @redirectToAnubis {\n return 307 /.within.website/?redir=$scheme://$host$request_uri;\n auth_request off;\n }\n\n location / {\n auth_request /.within.website/x/cmd/anubis/api/check;\n error_page 401 = @redirectToAnubis;\n root /usr/share/nginx/html;\n index index.html index.htm;\n }\n}\n```\n\n</details>\n\n## Caddy\n\nAnubis can be used with the [`forward_auth`](https://caddyserver.com/docs/caddyfile/directives/forward_auth) directive in Caddy.\n\nFirst, the `TARGET` environment variable in Anubis must be set to a space, eg:\n\n<Tabs>\n <TabItem value=\"env-file\" label=\"Environment file\" default>\n\n```shell\n# anubis.env\n\nTARGET=\" \"\n# ...\n```\n\n </TabItem>\n <TabItem value=\"docker-compose\" label=\"Docker Compose\">\n\n```yaml\nservices:\n anubis-caddy:\n image: ghcr.io/techarohq/anubis:latest\n environment:\n TARGET: \" \"\n # ...\n```\n\n </TabItem>\n <TabItem value=\"k8s\" label=\"Kubernetes\">\n\nInside your Deployment, StatefulSet, or Pod:\n\n```yaml\n- name: anubis\n image: ghcr.io/techarohq/anubis:latest\n env:\n - name: TARGET\n value: \" \"\n # ...\n```\n\n </TabItem>\n</Tabs>\n\nThen configure the necessary directives in your site block:\n\n```caddy\nroute {\n # Assumption: Anubis is running in the same network namespace as\n # caddy on localhost TCP port 8923\n reverse_proxy /.within.website/* 127.0.0.1:8923\n forward_auth 127.0.0.1:8923 {\n uri /.within.website/x/cmd/anubis/api/check\n trusted_proxies private_ranges\n @unauthorized status 401\n handle_response @unauthorized {\n redir * /.within.website/?redir={uri} 307\n }\n }\n}\n```\n\nIf you want to use this for multiple sites, you can create a [snippet](https://caddyserver.com/docs/caddyfile/concepts#snippets) and import it in multiple site blocks.\n"
},
{
"path": "docs/docs/admin/configuration/thresholds.mdx",
"content": "# Weight Threshold Configuration\n\nAnubis offers the ability to assign \"weight\" to requests. This is a custom level of suspicion that rules can add to or remove from. For example, here's how you assign 10 weight points to anything that might be a browser:\n\n```yaml\n# botPolicies.yaml\n\nbots:\n - name: generic-browser\n user_agent_regex: >-\n Mozilla|Opera\n action: WEIGH\n weight:\n adjust: 10\n```\n\nThresholds let you take this per-request weight value and take actions in response to it. Thresholds are defined alongside your bot configuration in `botPolicies.yaml`.\n\n:::note\n\nThresholds DO NOT apply when a request matches a bot rule with the CHALLENGE action. Thresholds only apply when requests don't match any terminal bot rules.\n\n:::\n\n```yaml\n# botPolicies.yaml\n\nbots: ...\n\nthresholds:\n - name: minimal-suspicion\n expression: weight < 0\n action: ALLOW\n\n - name: mild-suspicion\n expression:\n all:\n - weight >= 0\n - weight < 10\n action: CHALLENGE\n challenge:\n algorithm: metarefresh\n difficulty: 1\n\n - name: moderate-suspicion\n expression:\n all:\n - weight >= 10\n - weight < 20\n action: CHALLENGE\n challenge:\n algorithm: fast\n difficulty: 2\n\n - name: extreme-suspicion\n expression: weight >= 20\n action: CHALLENGE\n challenge:\n algorithm: fast\n difficulty: 4\n```\n\nThis defines a suite of 4 thresholds:\n\n1. If the request weight is less than zero, allow it through.\n2. If the request weight is greater than or equal to zero, but less than ten: give it [a very lightweight challenge](./challenges/metarefresh.mdx).\n3. If the request weight is greater than or equal to ten, but less than twenty: give it [a slightly heavier challenge](./challenges/proof-of-work.mdx).\n4. Otherwise, give it [the heaviest challenge](./challenges/proof-of-work.mdx).\n\nThresholds can be configured with the following options:\n\n<table>\n <thead>\n <tr>\n <th>Name</th>\n <th>Description</th>\n <th>Example</th>\n </tr>\n </thead>\n <tbody>\n <tr>\n <td>`name`</td>\n <td>The human-readable name for this threshold.</td>\n <td>\n\n```yaml\nname: extreme-suspicion\n```\n\n </td>\n </tr>\n <tr>\n <td>`expression`</td>\n <td>A [CEL](https://cel.dev/) expression taking the request weight and returning true or false</td>\n <td>\n\nTo check if the request weight is less than zero:\n\n```yaml\nexpression: weight < 0\n```\n\nTo check if it's between 0 and 10 (inclusive):\n\n```yaml\nexpression:\n all:\n - weight >= 0\n - weight < 10\n```\n\n </td>\n </tr>\n <tr>\n <td>`action`</td>\n <td>The Anubis action to apply: `ALLOW`, `CHALLENGE`, or `DENY`</td>\n <td>\n\n```yaml\naction: ALLOW\n```\n\nIf you set the CHALLENGE action, you must set challenge details:\n\n```yaml\naction: CHALLENGE\nchallenge:\n algorithm: metarefresh\n difficulty: 1\n```\n\n </td>\n </tr>\n\n </tbody>\n</table>\n"
},
{
"path": "docs/docs/admin/default-allow-behavior.mdx",
"content": "---\ntitle: Default allow behavior\n---\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\n# Default allow behavior\n\nAnubis is designed to be as unintrusive as possible to your existing infrastructure.\n\nBy default, it allows all traffic unless a request matches a rule that explicitly denies or challenges it.\n\nOnly requests matching a DENY or CHALLENGE rule are blocked or challenged. All other requests are allowed. This is called \"the implicit rule\".\n\n## Example: Minimal policy\n\nIf your policy only blocks a specific bot, all other requests will be allowed:\n\n<Tabs>\n<TabItem value=\"json\" label=\"JSON\" default>\n\n```json\n{\n \"bots\": [\n {\n \"name\": \"block-amazonbot\",\n \"user_agent_regex\": \"Amazonbot\",\n \"action\": \"DENY\"\n }\n ]\n}\n```\n\n</TabItem>\n<TabItem value=\"yaml\" label=\"YAML\">\n\n```yaml\n- name: block-amazonbot\n user_agent_regex: Amazonbot\n action: DENY\n```\n\n</TabItem>\n</Tabs>\n\n## How to deny by default\n\nIf you want to deny all traffic except what you explicitly allow, add a catch-all deny rule at the end of your policy list. Make sure to add ALLOW rules for any traffic you want to permit before this rule.\n\n<Tabs>\n<TabItem value=\"json\" label=\"JSON\" default>\n\n```json\n{\n \"bots\": [\n {\n \"name\": \"allow-goodbot\",\n \"user_agent_regex\": \"GoodBot\",\n \"action\": \"ALLOW\"\n },\n {\n \"name\": \"catch-all-deny\",\n \"path_regex\": \".*\",\n \"action\": \"DENY\"\n }\n ]\n}\n```\n\n</TabItem>\n<TabItem value=\"yaml\" label=\"YAML\">\n\n```yaml\n- name: allow-goodbot\n user_agent_regex: GoodBot\n action: ALLOW\n- name: catch-all-deny\n path_regex: .*\n action: DENY\n```\n\n</TabItem>\n</Tabs>\n\n## Final remarks\n\n- Rules are evaluated in order; the first match wins.\n- The implicit allow rule is always last and cannot be removed.\n- Use your logs to monitor what traffic is being allowed by default.\n\nSee [Policy Definitions](./policies) for more details on writing rules.\n"
},
{
"path": "docs/docs/admin/environments/_category_.json",
"content": "{\n \"label\": \"Environments\",\n \"position\": 20,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Detailed information about individual environments (such as HTTP servers, platforms, etc.) Anubis is known to work with.\"\n }\n}\n"
},
{
"path": "docs/docs/admin/environments/apache.mdx",
"content": "# Apache\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\nAnubis is intended to be a filter proxy. The way to integrate this is to break your configuration up into two parts: TLS termination and then HTTP routing. Consider this diagram:\n\n```mermaid\n---\ntitle: Apache as tls terminator and HTTP router\n---\n\nflowchart LR\n T(User Traffic)\n subgraph Apache 2\n TCP(TCP 80/443)\n US(TCP 3001)\n end\n\n An(Anubis)\n B(Backend)\n\n T --> |TLS termination| TCP\n TCP --> |Traffic filtering| An\n An --> |Happy traffic| US\n US --> |whatever you're doing| B\n```\n\nEffectively you have one trip through Apache to do TLS termination, a detour through Anubis for traffic scrubbing, and then going to the backend directly. This final socket is what will do HTTP routing.\n\n:::note\n\nThese examples assume that you are using a setup where your Apache configuration is made up of a bunch of files in `/etc/httpd/conf.d/*.conf`. This is not true for all deployments of Apache. If you are not in such an environment, append these snippets to your `/etc/httpd/conf/httpd.conf` file.\n\n:::\n\n## Configuration\n\nAssuming you are protecting `anubistest.techaro.lol`, you need the following server configuration blocks:\n\n1. A block on port 80 that forwards HTTP to HTTPS\n2. A block on port 443 that terminates TLS and forwards to Anubis\n3. A block on port 3001 that actually serves your websites\n\n```text\n# Plain HTTP redirect to HTTPS\n<VirtualHost *:80>\n ServerAdmin your@email.here\n ServerName anubistest.techaro.lol\n DocumentRoot /var/www/anubistest.techaro.lol\n ErrorLog /var/log/httpd/anubistest.techaro.lol_error.log\n CustomLog /var/log/httpd/anubistest.techaro.lol_access.log combined\n RewriteEngine on\n RewriteCond %{SERVER_NAME} =anubistest.techaro.lol\n RewriteRule ^ https://%{SERVER_NAME}%{REQUEST_URI} [END,NE,R=permanent]\n</VirtualHost>\n\n# HTTPS listener that forwards to Anubis\n<IfModule mod_proxy.c>\n<VirtualHost *:443>\n ServerAdmin your@email.here\n ServerName anubistest.techaro.lol\n DocumentRoot /var/www/anubistest.techaro.lol\n ErrorLog /var/log/httpd/anubistest.techaro.lol_error.log\n CustomLog /var/log/httpd/anubistest.techaro.lol_access.log combined\n\n SSLCertificateFile /etc/letsencrypt/live/anubistest.techaro.lol/fullchain.pem\n SSLCertificateKeyFile /etc/letsencrypt/live/anubistest.techaro.lol/privkey.pem\n Include /etc/letsencrypt/options-ssl-apache.conf\n\n # These headers need to be set or else Anubis will\n # throw an \"admin misconfiguration\" error.\n RequestHeader set \"X-Real-Ip\" expr=%{REMOTE_ADDR}\n RequestHeader set X-Forwarded-Proto \"https\"\n RequestHeader set \"X-Http-Version\" \"%{SERVER_PROTOCOL}s\"\n\n ProxyPreserveHost On\n\n ProxyRequests Off\n ProxyVia Off\n\n # Replace 9000 with the port Anubis listens on\n ProxyPass / http://[::1]:9000/\n ProxyPassReverse / http://[::1]:9000/\n</VirtualHost>\n</IfModule>\n\n# Actual website config\n<VirtualHost *:3001>\n ServerAdmin your@email.here\n ServerName anubistest.techaro.lol\n DocumentRoot /var/www/anubistest.techaro.lol\n ErrorLog /var/log/httpd/anubistest.techaro.lol_error.log\n CustomLog /var/log/httpd/anubistest.techaro.lol_access.log combined\n\n # Pass the remote IP to the proxied application instead of 127.0.0.1\n # This requires mod_remoteip\n RemoteIPHeader X-Real-IP\n RemoteIPTrustedProxy 127.0.0.1/32\n</VirtualHost>\n```\n\nMake sure to add a separate configuration file for the listener on port 3001:\n\n```text\n# /etc/httpd/conf.d/listener-3001.conf\n\nListen [::1]:3001\n```\n\nIn case you are running an IPv4-only system, use the following configuration instead:\n\n```text\n# /etc/httpd/conf.d/listener-3001.conf\n\nListen 127.0.0.1:3001\n```\n\nThis can be repeated for multiple sites. Anubis does not care about the HTTP `Host` header and will happily cope with multiple websites via the same instance.\n\nThen reload your Apache config and load your website. You should see Anubis protecting your apps!\n\n```text\nsudo systemctl reload httpd.service\n```\n\n## Troubleshooting\n\nHere are some answers to questions that came in in testing:\n\n### I'm running on a Red Hat distribution and Apache is saying \"service unavailable\" for every page load\n\nIf you see a \"Service unavailable\" error on every page load and run a Red Hat derived distribution, you are missing a `selinux` setting. The exact command will be in a journalctl log message like this:\n\n```text\n***** Plugin catchall_boolean (89.3 confidence) suggests ******************\n\nIf you want to allow HTTPD scripts and modules to connect to the network using TCP.\nThen you must tell SELinux about this by enabling the 'httpd_can_network_connect' boolean.\n\nDo\nsetsebool -P httpd_can_network_connect 1\n```\n\nThis will fix the error immediately.\n"
},
{
"path": "docs/docs/admin/environments/caddy.mdx",
"content": "# Caddy\n\nTo use Anubis with Caddy, stick Anubis between Caddy and your backend. For example, consider this application setup:\n\n```mermaid\n---\ntitle: Caddy with Anubis in the middle\n---\n\nflowchart LR\n T(User Traffic)\n TCP(TCP 80/443)\n An(Anubis)\n B(Backend)\n Blocked\n\n T --> TCP\n TCP --> |Traffic filtering| An\n An --> |Happy traffic| B\n An --> |Malicious traffic| Blocked\n```\n\nInstead of your traffic going directly to your backend, it takes a detour through Anubis. Anubis filters out the \"bad\" traffic and passes the \"good\" traffic to the backend.\n\nTo set up Anubis with Docker compose and Caddy, start with a `docker-compose` configuration like this:\n\n```yaml\nservices:\n caddy:\n image: caddy:2\n ports:\n - 80:80\n - 443:443\n - 443:443/udp\n volumes:\n - ./conf:/etc/caddy\n - caddy_config:/config\n - caddy_data:/data\n\n anubis:\n image: ghcr.io/techarohq/anubis:latest\n pull_policy: always\n environment:\n BIND: \":3000\"\n TARGET: http://httpdebug:3000\n\n httpdebug:\n image: ghcr.io/xe/x/httpdebug\n pull_policy: always\n\nvolumes:\n caddy_data:\n caddy_config:\n```\n\nAnd then put the following in `conf/Caddyfile`:\n\n```Caddyfile\n# conf/Caddyfile\n\nyourdomain.example.com {\n tls your@email.address\n\n reverse_proxy http://anubis:3000 {\n header_up X-Real-Ip {remote_host}\n header_up X-Http-Version {http.request.proto}\n }\n}\n```\n\nIf you want to protect multiple services with Anubis, you will need to either start multiple instances of Anubis (Anubis requires less than 32 MB of ram on average) or set up a two-tier routing setup where TLS termination is done with one instance of Caddy and the actual routing to services is done with another instance of Caddy. See the [nginx](./nginx.mdx) or [Apache](./apache.mdx) documentation to get ideas on how you would do this.\n"
},
{
"path": "docs/docs/admin/environments/cloudflare.mdx",
"content": "# Cloudflare\n\nIf you are using Cloudflare, you should configure your server to use `CF-Connecting-IP` as the source of the real client IP, and pass that address to Anubis as `X-Forwarded-For`. Read [Client IP Headers](../caveats-xff.mdx) for details.\n\nExample configuration with Caddy:\n\n```Caddyfile\n{\n servers {\n # Cloudflare IP ranges from https://www.cloudflare.com/en-gb/ips/\n trusted_proxies static 173.245.48.0/20 103.21.244.0/22 103.22.200.0/22 103.31.4.0/22 141.101.64.0/18 108.162.192.0/18 190.93.240.0/20 188.114.96.0/20 197.234.240.0/22 198.41.128.0/17 162.158.0.0/15 104.16.0.0/13 104.24.0.0/14 172.64.0.0/13 131.0.72.0/22 2400:cb00::/32 2606:4700::/32 2803:f800::/32 2405:b500::/32 2405:8100::/32 2a06:98c0::/29 2c0f:f248::/32\n # Use CF-Connecting-IP to determine the client IP instead of XFF\n # https://caddyserver.com/docs/caddyfile/options#client-ip-headers\n client_ip_headers CF-Connecting-IP\n }\n}\n\nexample.com {\n reverse_proxy http://anubis:3000 {\n # Pass the client IP read from CF-Connecting-IP\n header_up X-Forwarded-For {client_ip}\n header_up X-Real-IP {client_ip}\n header_up X-Http-Version {http.request.proto}\n }\n}\n```\n"
},
{
"path": "docs/docs/admin/environments/docker-compose.mdx",
"content": "# Docker compose\n\nDocker compose is typically used in concert with other load balancers such as [Apache](./apache.mdx) or [Nginx](./nginx.mdx). Below is a minimal example showing you how to set up an instance of Anubis listening on host port 8080 that points to a static website containing data in `./www`:\n\n```yaml\nservices:\n anubis:\n image: ghcr.io/techarohq/anubis:latest\n environment:\n BIND: \":8080\"\n DIFFICULTY: \"4\"\n METRICS_BIND: \":9090\"\n SERVE_ROBOTS_TXT: \"true\"\n TARGET: \"http://nginx\"\n POLICY_FNAME: \"/data/cfg/botPolicy.yaml\"\n OG_PASSTHROUGH: \"true\"\n OG_EXPIRY_TIME: \"24h\"\n healthcheck:\n test: [\"CMD\", \"anubis\", \"--healthcheck\"]\n interval: 5s\n timeout: 30s\n retries: 5\n start_period: 500ms\n ports:\n - 8080:8080\n volumes:\n - \"./botPolicy.yaml:/data/cfg/botPolicy.yaml:ro\"\n\n nginx:\n image: nginx\n volumes:\n - \"./www:/usr/share/nginx/html\"\n```\n"
},
{
"path": "docs/docs/admin/environments/haproxy/advanced-config-policy.yml",
"content": "# /etc/anubis/challenge-any.yml\n\nbots:\n - name: any\n action: CHALLENGE\n user_agent_regex: .*\n\nstatus_codes:\n CHALLENGE: 403\n DENY: 403\n\nthresholds: []\n\ndnsbl: false\n\n"
},
{
"path": "docs/docs/admin/environments/haproxy/advanced-config.env",
"content": "# /etc/anubis/default.env\n\nBIND=/run/anubis/default.sock\nBIND_NETWORK=unix\nDIFFICULTY=4\nMETRICS_BIND=:9090\n# target is irrelevant here, backend routing happens in HAProxy\nTARGET=http://0.0.0.0\nHS512_SECRET=<SECRET-HERE>\nCOOKIE_DYNAMIC_DOMAIN=True\nPOLICY_FNAME=/etc/anubis/challenge-any.yml\n"
},
{
"path": "docs/docs/admin/environments/haproxy/advanced-haproxy.cfg",
"content": "# /etc/haproxy/haproxy.cfg\n\nfrontend FE-multiple-applications\n mode http\n bind :80\n # ssl offloading on port 443 using a certificate from /etc/haproxy/ssl/ directory\n bind :443 ssl crt /etc/haproxy/ssl/ alpn h2,http/1.1 ssl-min-ver TLSv1.2 no-tls-tickets\n\n # set X-Real-IP header required for Anubis\n http-request set-header X-Real-IP \"%[src]\"\n\n # redirect HTTP to HTTPS\n http-request redirect scheme https code 301 unless { ssl_fc }\n # add HSTS header\n http-response set-header Strict-Transport-Security \"max-age=31536000; includeSubDomains; preload\"\n\n # only force Anubis challenge for app1 and app2\n acl acl_anubis_required hdr(host) -i \"app1.example.com\"\n acl acl_anubis_required hdr(host) -i \"app2.example.com\"\n\n # exclude Anubis for a specific path\n acl acl_anubis_ignore path /excluded/path\n\n # use Anubis if auth cookie not found\n use_backend BE-anubis if acl_anubis_required !acl_anubis_ignore !{ req.cook(techaro.lol-anubis-auth) -m found }\n\n # get payload of the JWT such as algorithm, expire time, restrictions\n http-request set-var(txn.anubis_jwt_alg) req.cook(techaro.lol-anubis-auth),jwt_header_query('$.alg') if acl_anubis_required !acl_anubis_ignore\n http-request set-var(txn.anubis_jwt_exp) cook(techaro.lol-anubis-auth),jwt_payload_query('$.exp','int') if acl_anubis_required !acl_anubis_ignore\n http-request set-var(txn.anubis_jwt_res) cook(techaro.lol-anubis-auth),jwt_payload_query('$.restriction') if acl_anubis_required !acl_anubis_ignore\n http-request set-var(txn.srcip) req.fhdr(X-Real-IP) if acl_anubis_required !acl_anubis_ignore\n http-request set-var(txn.now) date() if acl_anubis_required !acl_anubis_ignore\n\n # use Anubis if JWT has wrong algorithm, is expired, restrictions don't match or isn't signed with the correct key\n use_backend BE-anubis if acl_anubis_required !acl_anubis_ignore !{ var(txn.anubis_jwt_alg) -m str HS512 }\n use_backend BE-anubis if acl_anubis_required !acl_anubis_ignore { var(txn.anubis_jwt_exp),sub(txn.now) -m int lt 0 }\n use_backend BE-anubis if acl_anubis_required !acl_anubis_ignore !{ var(txn.srcip),digest(sha256),hex,lower,strcmp(txn.anubis_jwt_res) eq 0 }\n use_backend BE-anubis if acl_anubis_required !acl_anubis_ignore !{ cook(techaro.lol-anubis-auth),jwt_verify(txn.anubis_jwt_alg,\"<SECRET-HERE>\") -m int 1 }\n\n # custom routing in HAProxy\n use_backend BE-app1 if { hdr(host) -i \"app1.example.com\" }\n use_backend BE-app2 if { hdr(host) -i \"app2.example.com\" }\n use_backend BE-app3 if { hdr(host) -i \"app3.example.com\" }\n\nbackend BE-app1\n mode http\n server app1-server 127.0.0.1:3000\n\nbackend BE-app2\n mode http\n server app2-server 127.0.0.1:4000\n\nbackend BE-app3\n mode http\n server app3-server 127.0.0.1:5000\n\nBE-anubis\n mode http\n server anubis /run/anubis/default.sock\n"
},
{
"path": "docs/docs/admin/environments/haproxy/simple-config.env",
"content": "# /etc/anubis/default.env\n\nBIND=/run/anubis/default.sock\nBIND_NETWORK=unix\nSOCKET_MODE=0666\nDIFFICULTY=4\nMETRICS_BIND=:9090\nCOOKIE_DYNAMIC_DOMAIN=true\n# address and port of the actual application\nTARGET=http://localhost:3000\n"
},
{
"path": "docs/docs/admin/environments/haproxy/simple-haproxy.cfg",
"content": "# /etc/haproxy/haproxy.cfg\n\nfrontend FE-application\n mode http\n bind :80\n # ssl offloading on port 443 using a certificate from /etc/haproxy/ssl/ directory\n bind :443 ssl crt /etc/haproxy/ssl/ alpn h2,http/1.1 ssl-min-ver TLSv1.2 no-tls-tickets\n\n # set X-Real-IP header required for Anubis\n http-request set-header X-Real-IP \"%[src]\"\n\n # redirect HTTP to HTTPS\n http-request redirect scheme https code 301 unless { ssl_fc }\n # add HSTS header\n http-response set-header Strict-Transport-Security \"max-age=31536000; includeSubDomains; preload\"\n\n # route to Anubis backend by default\n default_backend BE-anubis-application\n\nBE-anubis-application\n mode http\n server anubis /run/anubis/default.sock\n"
},
{
"path": "docs/docs/admin/environments/haproxy.mdx",
"content": "# HAProxy\n\nimport CodeBlock from \"@theme/CodeBlock\";\n\nTo use Anubis with HAProxy, you have two variants:\n - simple - stick Anubis between HAProxy and your application backend (simple)\n - perfect if you only have a single application in general\n - advanced - force Anubis challenge by default and route to the application backend by HAProxy if the challenge is correct\n - useful for complex setups\n - routing can be done in HAProxy\n - define ACLs in HAProxy for domains, paths etc which are required/excluded regarding Anubis\n - HAProxy 3.0 recommended\n\n## Simple Variant\n\n```mermaid\n---\ntitle: HAProxy with simple config\n---\nflowchart LR\n T(User Traffic)\n HAProxy(HAProxy Port 80/443)\n Anubis\n Application\n\n T --> HAProxy\n HAProxy --> Anubis\n Anubis --> |Happy Traffic| Application\n```\n\nYour Anubis env file configuration may look like this:\n\nimport simpleAnubis from \"!!raw-loader!./haproxy/simple-config.env\";\n\n<CodeBlock language=\"bash\">{simpleAnubis}</CodeBlock>\n\nThe important part is that `TARGET` points to your actual application and if Anubis and HAProxy are on the same machine, a UNIX socket can be used.\n\nYour frontend and backend configuration of HAProxy may look like the following:\n\nimport simpleHAProxy from \"!!raw-loader!./haproxy/simple-haproxy.cfg\";\n\n<CodeBlock language=\"bash\">{simpleHAProxy}</CodeBlock>\n\nThis simply enables SSL offloading, sets some useful and required headers and routes to Anubis directly.\n\n## Advanced Variant\n\nDue to the fact that HAProxy can decode JWT, we are able to verify the Anubis token directly in HAProxy and route the traffic to the specific backends ourselves.\n\nMind that rule logic to allow Git HTTP and other legit bot traffic to bypass is delegated from Anubis to HAProxy then. If required, you should implement any whitelisting in HAProxy using `acl_anubis_ignore` yourself.\n\nIn this example are three applications behind one HAProxy frontend. Only App1 and App2 are secured via Anubis; App3 is open for everyone. The path `/excluded/path` can also be accessed by anyone.\n\n```mermaid\n---\ntitle: HAProxy with advanced config\n---\n\nflowchart LR\n T(User Traffic)\n HAProxy(HAProxy Port 80/443)\n B1(App1)\n B2(App2)\n B3(App3)\n Anubis\n\n T --> HAProxy\n HAProxy --> |Traffic for App1 and App2 without valid challenge| Anubis\n HAProxy --> |app1.example.com | B1\n HAProxy --> |app2.example.com| B2\n HAProxy --> |app3.example.com| B3\n```\n\n:::note\n\nFor an improved JWT decoding performance, it's recommended to use HAProxy version 3.0 or above.\n\n:::\n\nYour Anubis env file configuration may look like this:\n\nimport advancedAnubis from \"!!raw-loader!./haproxy/advanced-config.env\";\n\n<CodeBlock language=\"bash\">{advancedAnubis}</CodeBlock>\n\nIt's important to use `HS512_SECRET` which HAProxy understands. Please replace `<SECRET-HERE>` with your own secret string (alphanumerical string with 128 characters recommended).\n\nYou can set Anubis to force a challenge for every request using the following policy file:\n\nimport advancedAnubisPolicy from \"!!raw-loader!./haproxy/advanced-config-policy.yml\";\n\n<CodeBlock language=\"yaml\">{advancedAnubisPolicy}</CodeBlock>\n\nThe HAProxy config file may look like this:\n\nimport advancedHAProxy from \"!!raw-loader!./haproxy/advanced-haproxy.cfg\";\n\n<CodeBlock language=\"haproxy\">{advancedHAProxy}</CodeBlock>\n\nPlease replace `<SECRET-HERE>` with the same secret from the Anubis config.\n"
},
{
"path": "docs/docs/admin/environments/kubernetes.mdx",
"content": "# Kubernetes\n\n:::note\nLeave the `PUBLIC_URL` environment variable unset in this sidecar/standalone setup. Setting it here makes redirect construction fail (`redir=null`).\n:::\n\nWhen setting up Anubis in Kubernetes, you want to make sure that you thread requests through Anubis kinda like this:\n\n```mermaid\n---\ntitle: Anubis embedded into workload pods\n---\n\nflowchart LR\n T(User Traffic)\n\n IngressController(IngressController)\n\n subgraph Service\n AnPort(Anubis Port)\n BPort(Backend Port)\n end\n\n subgraph Pod\n An(Anubis)\n B(Backend)\n end\n\n T --> IngressController\n IngressController --> AnPort\n AnPort --> An\n An --> B\n```\n\nAnubis is lightweight enough that you should be able to have many instances of it running without many problems. If this is a concern for you, please check out [ingress-anubis](https://github.com/jaredallard/ingress-anubis?ref=anubis.techaro.lol).\n\nThis example makes the following assumptions:\n\n- Your target service is listening on TCP port `5000`.\n- Anubis will be listening on port `8080`.\n\nAdjust these values as facts and circumstances demand.\n\nCreate a secret with the signing key Anubis should use for its responses:\n\n```\nkubectl create secret generic anubis-key \\\n --namespace default \\\n --from-literal=ED25519_PRIVATE_KEY_HEX=$(openssl rand -hex 32)\n```\n\nAttach Anubis to your Deployment:\n\n```yaml\ncontainers:\n # ...\n - name: anubis\n image: ghcr.io/techarohq/anubis:latest\n imagePullPolicy: Always\n env:\n - name: \"BIND\"\n value: \":8080\"\n - name: \"DIFFICULTY\"\n value: \"4\"\n - name: ED25519_PRIVATE_KEY_HEX\n valueFrom:\n secretKeyRef:\n name: anubis-key\n key: ED25519_PRIVATE_KEY_HEX\n - name: \"METRICS_BIND\"\n value: \":9090\"\n - name: \"SERVE_ROBOTS_TXT\"\n value: \"true\"\n - name: \"TARGET\"\n value: \"http://localhost:5000\"\n - name: \"OG_PASSTHROUGH\"\n value: \"true\"\n - name: \"OG_EXPIRY_TIME\"\n value: \"24h\"\n resources:\n limits:\n cpu: 750m\n memory: 256Mi\n requests:\n cpu: 250m\n memory: 256Mi\n securityContext:\n runAsUser: 1000\n runAsGroup: 1000\n runAsNonRoot: true\n allowPrivilegeEscalation: false\n capabilities:\n drop:\n - ALL\n seccompProfile:\n type: RuntimeDefault\n```\n\nThen add a Service entry for Anubis:\n\n```yaml\n# ...\nspec:\n ports:\n # diff-add\n - protocol: TCP\n # diff-add\n port: 8080\n # diff-add\n targetPort: 8080\n # diff-add\n name: anubis\n```\n\nThen point your Ingress to the Anubis port:\n\n```yaml\n rules:\n - host: git.xeserv.us\n http:\n paths:\n - pathType: Prefix\n path: \"/\"\n backend:\n service:\n name: git\n port:\n # diff-remove\n name: http\n # diff-add\n name: anubis\n```\n\n## Envoy Gateway\n\nIf you are using envoy-gateway, the `X-Real-Ip` header is not set by default, but Anubis does require it. You can resolve this by adding the header, either on the specific `HTTPRoute` where Anubis is listening, or on the `ClientTrafficPolicy` to apply it to any number of Gateways:\n\nHTTPRoute:\n```yaml\napiVersion: gateway.networking.k8s.io/v1\nkind: HTTPRoute\nmetadata:\n name: app-route\nspec:\n hostnames: [\"app.domain.tld\"]\n parentRefs:\n - name: envoy-external\n namespace: network\n sectionName: https\n rules:\n - backendRefs:\n - identifier: *app\n port: anubis\n filters:\n - type: RequestHeaderModifier\n requestHeaderModifier:\n set:\n - name: X-Real-Ip\n value: \"%DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT%\"\n```\n\nApplying to any number of Gateways:\n```yaml\napiVersion: gateway.envoyproxy.io/v1alpha1\nkind: ClientTrafficPolicy\nmetadata:\n name: envoy\nspec:\n headers:\n earlyRequestHeaders:\n set:\n - name: X-Real-Ip\n value: \"%DOWNSTREAM_REMOTE_ADDRESS_WITHOUT_PORT%\"\n clientIPDetection:\n xForwardedFor:\n trustedCIDRs:\n - 10.96.0.0/16 # Cluster pod CIDR\n targetSelectors: # These will apply to all Gateways\n - group: gateway.networking.k8s.io\n kind: Gateway\n```\n"
},
{
"path": "docs/docs/admin/environments/nginx/conf-anubis.inc",
"content": "# /etc/nginx/conf-anubis.inc # Forward to anubis location / { proxy_set_header\nHost $host; proxy_set_header X-Real-IP $remote_addr; proxy_pass http://anubis; }\n"
},
{
"path": "docs/docs/admin/environments/nginx/server-anubistest-techaro-lol.conf",
"content": "# /etc/nginx/conf.d/server-anubistest-techaro-lol.conf\n\n# HTTP - Redirect all HTTP traffic to HTTPS\nserver {\n listen 80;\n listen [::]:80;\n\n server_name anubistest.techaro.lol;\n\n location / {\n return 301 https://$host$request_uri;\n }\n}\n\n# TLS termination server, this will listen over TLS (https) and then\n# proxy all traffic to the target via Anubis.\nserver {\n # Listen on TCP port 443 with TLS (https) and HTTP/2\n listen 443 ssl;\n listen [::]:443 ssl;\n http2 on;\n\n location / {\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n proxy_set_header X-Http-Version $server_protocol;\n proxy_pass http://anubis;\n }\n\n server_name anubistest.techaro.lol;\n\n ssl_certificate /path/to/your/certs/anubistest.techaro.lol.crt;\n ssl_certificate_key /path/to/your/certs/anubistest.techaro.lol.key;\n}\n\n# Backend server, this is where your webapp should actually live.\nserver {\n listen unix:/run/nginx/nginx.sock;\n\n server_name anubistest.techaro.lol;\n root \"/srv/http/anubistest.techaro.lol\";\n index index.html;\n\n # Get the visiting IP from the TLS termination server\n set_real_ip_from unix:;\n real_ip_header X-Real-IP;\n\n # Your normal configuration can go here\n # location .php { fastcgi...} etc.\n}"
},
{
"path": "docs/docs/admin/environments/nginx/server-mimi-techaro-lol.conf",
"content": "# /etc/nginx/conf.d/server-mimi-techaro-lol.conf\n\nserver {\n # Listen on 443 with SSL\n listen 443 ssl;\n listen [::]:443 ssl;\n http2 on;\n\n # Slipstream via Anubis\n include \"conf-anubis.inc\";\n\n server_name mimi.techaro.lol;\n\n ssl_certificate /path/to/your/certs/mimi.techaro.lol.crt;\n ssl_certificate_key /path/to/your/certs/mimi.techaro.lol.key;\n}\n\nserver {\n listen unix:/run/nginx/nginx.sock;\n\n server_name mimi.techaro.lol;\n\n port_in_redirect off;\n root \"/srv/http/mimi.techaro.lol\";\n index index.html;\n\n # Your normal configuration can go here\n # location .php { fastcgi...} etc.\n}"
},
{
"path": "docs/docs/admin/environments/nginx/upstream-anubis.conf",
"content": "# /etc/nginx/conf.d/upstream-anubis.conf\n\nupstream anubis {\n # Make sure this matches the values you set for `BIND` and `BIND_NETWORK`.\n # If this does not match, your services will not be protected by Anubis.\n\n # Try anubis first over a UNIX socket\n server unix:/run/anubis/nginx.sock;\n #server 127.0.0.1:8923;\n\n # Optional: fall back to serving the websites directly. This allows your\n # websites to be resilient against Anubis failing, at the risk of exposing\n # them to the raw internet without protection. This is a tradeoff and can\n # be worth it in some edge cases.\n #server unix:/run/nginx.sock backup;\n}"
},
{
"path": "docs/docs/admin/environments/nginx.mdx",
"content": "# Nginx\n\nimport CodeBlock from \"@theme/CodeBlock\";\n\nAnubis is intended to be a filter proxy. The way to integrate this with nginx is to break your configuration up into two parts: TLS termination and then HTTP routing. Consider this diagram:\n\n```mermaid\n---\ntitle: Nginx as tls terminator and HTTP router\n---\n\nflowchart LR\n T(User Traffic)\n subgraph Nginx\n TCP(TCP 80/443)\n US(Unix Socket or\nanother TCP port)\n end\n\n An(Anubis)\n B(Backend)\n\n T --> |TLS termination| TCP\n TCP --> |Traffic filtering| An\n An --> |Happy traffic| US\n US --> |whatever you're doing| B\n```\n\nInstead of your traffic going right from TLS termination into the backend, it takes a detour through Anubis. Anubis filters out the \"bad\" traffic and then passes the \"good\" traffic to another socket that Nginx has open. This final socket is what you will use to do HTTP routing.\n\nEffectively, you have two roles for nginx: TLS termination (converting HTTPS to HTTP) and HTTP routing (distributing requests to the individual vhosts). This can stack with something like Apache in case you have a legacy deployment. Make sure you have the right [TLS certificates configured](https://code.kuederle.com/letsencrypt/) at the TLS termination level.\n\n:::note\n\nThese examples assume that you are using a setup where your nginx configuration is made up of a bunch of files in `/etc/nginx/conf.d/*.conf`. This is not true for all deployments of nginx. If you are not in such an environment, append these snippets to your `/etc/nginx/nginx.conf` file.\n\n:::\n\nAssuming that we are protecting `anubistest.techaro.lol`, here's what the server configuration file would look like:\n\nimport anubisTest from \"!!raw-loader!./nginx/server-anubistest-techaro-lol.conf\";\n\n<CodeBlock language=\"nginx\">{anubisTest}</CodeBlock>\n\n:::tip\n\nYou can copy the `location /` block into a separate file named something like `conf-anubis.inc` and then include it inline to other `server` blocks:\n\nimport anubisInclude from \"!!raw-loader!./nginx/conf-anubis.inc\";\n\n<CodeBlock language=\"nginx\">{anubisInclude}</CodeBlock>\n\nThen in a server block:\n\n<details>\n<summary>Full nginx config</summary>\n\nimport mimiTecharoLol from \"!!raw-loader!./nginx/server-mimi-techaro-lol.conf\";\n\n<CodeBlock language=\"nginx\">{mimiTecharoLol}</CodeBlock>\n\n</details>\n\n:::\n\nCreate an upstream for Anubis.\n\nimport anubisUpstream from \"!!raw-loader!./nginx/upstream-anubis.conf\";\n\n<CodeBlock language=\"nginx\">{anubisUpstream}</CodeBlock>\n\nThis can be repeated for multiple sites. Anubis does not care about the HTTP `Host` header and will happily cope with multiple websites via the same instance.\n\nThen reload your nginx config and load your website. You should see Anubis protecting your apps!\n\n```text\nsudo systemctl reload nginx.service\n```\n"
},
{
"path": "docs/docs/admin/environments/traefik.mdx",
"content": "---\nid: traefik\ntitle: Traefik\n---\n\n:::note\n\nThis only talks about integration through Compose,\nbut it also applies to docker cli options.\n\n:::\n\nIn this example, we will use 4 Containers:\n\n- `traefik` - the Traefik instance\n- `anubis` - the Anubis instance\n- `target` - our service to protect (`traefik/whoami` in this case)\n- `target2` - a second service that isn't supposed to be protected (`traefik/whoami` in this case)\n\n## Diagram of Flow\n\nThis is a small diagram depicting the flow.\nKeep in mind that `8080` or `80` can be anything depending on your containers.\n\n```mermaid\nflowchart LR\nuser[User]\ntraefik[Traefik]\nanubis[Anubis]\ntarget[Target]\n\nuser-->|:443 - Requesting Service|traefik\ntraefik-->|:8080 - Check authorization to Anubis|anubis\nanubis-->|redirect if failed|traefik\nuser-->|:8080 - make the challenge|traefik\nanubis-->|redirect back to target|traefik\ntraefik-->|:80 - Passing to the target|target\n```\n\n## Full Example Config\n\nThis example contains 3 services: anubis, one that is protected and the other one that is not.\n\n**compose.yml**\n\n```yml\nservices:\n traefik:\n image: traefik:v3.3\n ports:\n - 80:80\n - 443:443\n volumes:\n - /var/run/docker.sock:/var/run/docker.sock\n - ./letsencrypt:/letsencrypt\n - ./traefik.yml:/traefik.yml:ro\n networks:\n - traefik\n labels:\n # Enable Traefik\n - traefik.enable=true\n - traefik.docker.network=traefik\n # Anubis middleware\n - traefik.http.middlewares.anubis.forwardauth.address=http://anubis:8080/.within.website/x/cmd/anubis/api/check\n # Redirect any HTTP to HTTPS\n - traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https\n - traefik.http.routers.web.rule=PathPrefix(`/`)\n - traefik.http.routers.web.entrypoints=web\n - traefik.http.routers.web.middlewares=redirect-to-https\n - traefik.http.routers.web.tls=false\n\n anubis:\n image: ghcr.io/techarohq/anubis:main\n environment:\n # Telling Anubis, where to listen for Traefik\n - BIND=:8080\n # Telling Anubis to do redirect — ensure there is a space after '='\n - \"TARGET= \"\n # Specifies which domains Anubis is allowed to redirect to.\n - REDIRECT_DOMAINS=example.com\n # Should be the full external URL for Anubis (including scheme)\n - PUBLIC_URL=https://anubis.example.com\n # Should match your domain for proper cookie scoping\n - COOKIE_DOMAIN=example.com\n networks:\n - traefik\n labels:\n - traefik.enable=true # Enabling Traefik\n - traefik.docker.network=traefik # Telling Traefik which network to use\n - traefik.http.routers.anubis.rule=Host(`anubis.example.com`) # Only Matching Requests for example.com\n - traefik.http.routers.anubis.entrypoints=websecure # Listen on HTTPS\n - traefik.http.services.anubis.loadbalancer.server.port=8080 # Telling Traefik where to receive requests\n - traefik.http.routers.anubis.service=anubis # Telling Traefik to use the above specified port\n - traefik.http.routers.anubis.tls.certresolver=le # Telling Traefik to resolve a Cert for Anubis\n\n # Protected by Anubis\n target:\n image: traefik/whoami:latest\n networks:\n - traefik\n labels:\n - traefik.enable=true # Enabling Traefik\n - traefik.docker.network=traefik # Telling Traefik which network to use\n - traefik.http.routers.target.rule=Host(`example.com`) # Only Matching Requests for example.com\n - traefik.http.routers.target.entrypoints=websecure # Listening on the exclusive Anubis Network\n - traefik.http.services.target.loadbalancer.server.port=80 # Telling Traefik where to receive requests\n - traefik.http.routers.target.service=target # Telling Traefik to use the above specified port\n - traefik.http.routers.target.tls.certresolver=le # Telling Traefik to resolve a Cert for Anubis\n - traefik.http.routers.target.middlewares=anubis@docker # Use the Anubis middleware\n\n # Not Protected by Anubis\n target2:\n image: traefik/whoami:latest\n networks:\n - traefik\n labels:\n - traefik.enable=true # Enabling Traefik\n - traefik.docker.network=traefik # Telling Traefik which network to use\n - traefik.http.routers.target2.rule=Host(`another.example.com`) # Only Matching Requests for example.com\n - traefik.http.routers.target2.entrypoints=websecure # Listening on the exclusive Anubis Network\n - traefik.http.services.target2.loadbalancer.server.port=80 # Telling Traefik where to receive requests\n - traefik.http.routers.target2.service=target2 # Telling Traefik to use the above specified port\n - traefik.http.routers.target2.tls.certresolver=le # Telling Traefik to resolve a Cert for this Target\n\nnetworks:\n traefik:\n name: traefik\n```\n\n**traefik.yml**\n\n```yml\napi:\n insecure: false # shouldn't be enabled in prod\n\nentryPoints:\n # Web\n web:\n address: \":80\"\n websecure:\n address: \":443\"\n\ncertificatesResolvers:\n le:\n acme:\n tlsChallenge: {}\n email: \"admin@example.com\"\n storage: \"/letsencrypt/acme.json\"\n\nproviders:\n docker: {}\n```\n"
},
{
"path": "docs/docs/admin/frameworks/_category_.json",
"content": "{\n \"label\": \"Frameworks\",\n \"position\": 30,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Information about getting specific frameworks or tools working with Anubis.\"\n }\n}\n"
},
{
"path": "docs/docs/admin/frameworks/htmx.mdx",
"content": "# HTMX\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\n[HTMX](https://htmx.org) is a framework that enables you to write applications using hypertext as the engine of application state. This enables you to simplify you server side code by having it return HTML instead of JSON. This can interfere with Anubis because Anubis challenge pages also return HTML.\n\nTo work around this, you can make a custom [expression](../configuration/expressions.mdx) rule that allows HTMX requests if the user has passed a challenge in the past:\n\n```yaml\n- name: allow-htmx-iff-already-passed-challenge\n action: ALLOW\n expression:\n all:\n - '\"Cookie\" in headers'\n - 'headers[\"Cookie\"].contains(\"anubis-auth\")'\n - '\"Hx-Request\" in headers'\n - 'headers[\"Hx-Request\"] == \"true\"'\n```\n\nThis will reduce some security because it does not assert the validity of the Anubis auth cookie, however in trade it improves the experience for existing users.\n"
},
{
"path": "docs/docs/admin/frameworks/wordpress.mdx",
"content": "# WordPress\n\nWordPress is the most popular blog engine on the planet.\n\n## Using a multi-site setup with Anubis\n\nIf you have a multi-site setup where traffic goes through Anubis like this:\n\n```mermaid\n---\ntitle: Apache as tls terminator and HTTP router\n---\n\nflowchart LR\n T(User Traffic)\n subgraph Apache 2\n TCP(TCP 80/443)\n US(TCP 3001)\n end\n\n An(Anubis)\n B(Backend)\n\n T --> |TLS termination| TCP\n TCP --> |Traffic filtering| An\n An --> |Happy traffic| US\n US --> |whatever you're doing| B\n```\n\nWordPress may not realize that the underlying connection is being done over HTTPS. This could lead to a redirect loop in the `/wp-admin/` routes. In order to fix this, add the following to your `wp-config.php` file:\n\n```php\nif (isset($_SERVER['HTTP_X_FORWARDED_PROTO']) && $_SERVER['HTTP_X_FORWARDED_PROTO'] === 'https') {\n $_SERVER['HTTPS'] = 'on';\n $_SERVER['SERVER_PORT'] = 443;\n}\n```\n\nThis will make WordPress think that your connection is over HTTPS instead of plain HTTP.\n"
},
{
"path": "docs/docs/admin/honeypot/_category_.json",
"content": "{\n \"label\": \"Honeypot\",\n \"position\": 40,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Honeypot features in Anubis, allowing Anubis to passively detect malicious crawlers.\"\n }\n}\n"
},
{
"path": "docs/docs/admin/honeypot/overview.mdx",
"content": "---\ntitle: Dataset poisoning\n---\n\nAnubis offers the ability to participate in [dataset poisoning](https://www.anthropic.com/research/small-samples-poison) attacks similar to what [iocaine](https://iocaine.madhouse-project.org/) and other similar tools offer. Currently this is in a preview state where a lot of details are hard-coded in order to test the viability of this approach.\n\nIn essence, when Anubis challenge and error pages are rendered they include a small bit of HTML code that browsers will ignore but scrapers will interpret as a link to ingest. This will then create a small forest of recursive nothing pages that are designed according to the following principles:\n\n- These pages are _cheap_ to render, rendering in at most ten milliseconds on decently specced hardware.\n- These pages are _vacuous_, meaning that they essentially are devoid of content such that a human would find it odd and click away, but a scraper would not be able to know that and would continue through the forest.\n- These pages are _fairly large_ so that scrapers don't think that the pages are error pages or are otherwise devoid of content.\n- These pages are _fully self-contained_ so that they load fast without incurring additional load from resource fetches.\n\nIn this limited preview state, Anubis generates pages using [spintax](https://outboundly.ai/blogs/what-is-spintax-and-how-to-use-it/). Spintax is a syntax that is used to create different variants of utterances for use in marketing messages and email spam that evades word filtering. In its current form, Anubis' dataset poisoning has AI generated spintax that generates vapid LinkedIn posts with some western occultism thrown in for good measure. This results in utterances like the following:\n\n> There's a moment when visionaries are being called to realize that the work can't be reduced to optimization, but about resonance. We don't transform products by grinding endlessly, we do it by holding the vision. Because meaning can't be forced, it unfolds over time when culture are in integrity. This moment represents a fundamental reimagining in how we think about work. This isn't a framework, it's a lived truth that requires courage. When we get honest, we activate nonlinear growth that don't show up in dashboards, but redefine success anyway.\n\nThis should be fairly transparent to humans that this is pseudoprofound anti-content and is a signal to click away.\n\n## Plans\n\nFuture versions of this feature will allow for more customization. In the near future this will be configurable via the following mechanisms:\n\n- WebAssembly logic for customizing how the poisoning data is generated (with examples including the existing spintax method).\n- Weight thresholds and logic for how they are interpreted by Anubis.\n- Other configuration settings as facts and circumstances dictate.\n\n## Implementation notes\n\nIn its current implementation, the Anubis dataset poisoning feature has the following flaws that may hinder production deployments:\n\n- All Anubis instances use the same method for generating dataset poisoning information. This may be easy for malicious actors to detect and ignore.\n- Anubis dataset poisoning routes are under the `/.within.website/x/cmd/anubis` URL hierarchy. This may be easy for malicious actors to detect and ignore.\n\nRight now Anubis assigns 30 weight points if the following criteria are met:\n\n- A client's User-Agent has been observed in the dataset poisoning maze at least 25 times.\n- The network-clamped IP address (/24 for IPv4 and /48 for IPv6) has been observed in the dataset poisoning maze at least 25 times.\n\nAdditionally, when any given client by both User-Agent and network-clamped IP address has been observed, Anubis will emit log lines warning about it so that administrative action can be taken up to and including [filing abuse reports with the network owner](/blog/2025/file-abuse-reports).\n"
},
{
"path": "docs/docs/admin/installation.mdx",
"content": "---\ntitle: Setting up Anubis\n---\n\nimport EnterpriseOnly from \"@site/src/components/EnterpriseOnly\";\nimport RandomKey from \"@site/src/components/RandomKey\";\n\nexport const EO = () => (\n <>\n <EnterpriseOnly link=\"./botstopper/\" />\n <div style={{ marginBottom: \"0.5rem\" }} />\n </>\n);\n\nAnubis is meant to sit between your reverse proxy (such as Nginx or Caddy) and your target service. One instance of Anubis must be used per service you are protecting.\n\n<center>\n\n```mermaid\n---\ntitle: With Anubis installed\n---\n\nflowchart LR\n LB(Load balancer /\nTLS terminator)\n Anubis(Anubis)\n App(App)\n\n LB --> Anubis --> App\n```\n\n</center>\n\n## Docker image conventions\n\nAnubis is shipped in the Docker repo [`ghcr.io/techarohq/anubis`](https://github.com/TecharoHQ/anubis/pkgs/container/anubis). The following tags exist for your convenience:\n\n| Tag | Meaning |\n| :------------------ | :--------------------------------------------------------------------------------------------------------------------------------- |\n| `latest` | The latest [tagged release](https://github.com/TecharoHQ/anubis/releases), if you are in doubt, start here. |\n| `v<version number>` | The Anubis image for [any given tagged release](https://github.com/TecharoHQ/anubis/tags) |\n| `main` | The current build on the `main` branch. Only use this if you need the latest and greatest features as they are merged into `main`. |\n\nThe Docker image runs Anubis as user ID 1000 and group ID 1000. If you are mounting external volumes into Anubis' container, please be sure they are owned by or writable to this user/group.\n\nAnubis has very minimal system requirements. I suspect that 128Mi of ram may be sufficient for a large number of concurrent clients. Anubis may be a poor fit for apps that use WebSockets and maintain open connections, but I don't have enough real-world experience to know one way or another.\n\n## Native packages\n\nFor more detailed information on installing Anubis with native packages, please read [the native install directions](./native-install.mdx).\n\n## Configuration\n\nAnubis is configurable via environment variables and [the policy file](./policies.mdx). Most settings are currently exposed with environment variables but they are being slowly moved over to the policy file.\n\n### Configuration via the policy file\n\nCurrently the following settings are configurable via the policy file:\n\n- [Bot policies](./policies.mdx)\n- [Open Graph passthrough](./configuration/open-graph.mdx)\n- [Weight thresholds](./configuration/thresholds.mdx)\n\n### Environment variables\n\nAnubis uses these environment variables for configuration:\n\n| Environment Variable | Default value | Explanation |\n| :----------------------------- | :---------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `ASSET_LOOKUP_HEADER` | unset | <EO /> If set, use the contents of this header in requests when looking up custom assets in `OVERLAY_FOLDER`. See [Header-based overlay dispatch](./botstopper.mdx#header-based-overlay-dispatch) for more details. |\n| `BASE_PREFIX` | unset | If set, adds a global prefix to all Anubis endpoints (everything starting with `/.within.website/x/anubis/`). For example, setting this to `/myapp` would make Anubis accessible at `/myapp/` instead of `/`. This is useful when running Anubis behind a reverse proxy that routes based on path prefixes. |\n| `BIND` | `:8923` | The network address that Anubis listens on. For `unix`, set this to a path: `/run/anubis/instance.sock` |\n| `BIND_NETWORK` | `tcp` | The address family that Anubis listens on. Accepts `tcp`, `unix` and anything Go's [`net.Listen`](https://pkg.go.dev/net#Listen) supports. |\n| `CHALLENGE_TITLE` | unset | <EO /> If set, override the translation stack to show a custom title for challenge pages such as \"Making sure your connection is secure!\". See [Customizing messages](./botstopper.mdx#customizing-messages) for more details. |\n| `COOKIE_DOMAIN` | unset | The domain the Anubis challenge pass cookie should be set to. This should be set to the domain you bought from your registrar (EG: `techaro.lol` if your webapp is running on `anubis.techaro.lol`). See this [stackoverflow explanation of cookies](https://stackoverflow.com/a/1063760) for more information.<br/><br/>Note that unlike `REDIRECT_DOMAINS`, you should never include a port number in this variable. |\n| `COOKIE_DYNAMIC_DOMAIN` | false | If set to true, automatically set cookie domain fields based on the hostname of the request. EG: if you are making a request to `anubis.techaro.lol`, the Anubis cookie will be valid for any subdomain of `techaro.lol`. |\n| `COOKIE_EXPIRATION_TIME` | `168h` | The amount of time the authorization cookie is valid for. |\n| `CUSTOM_REAL_IP_HEADER` | unset | If set, Anubis will read the client's real IP address from this header, and set it in `X-Real-IP` header. |\n| `COOKIE_PARTITIONED` | `false` | If set to `true`, enables the [partitioned (CHIPS) flag](https://developers.google.com/privacy-sandbox/cookies/chips), meaning that Anubis inside an iframe has a different set of cookies than the domain hosting the iframe. |\n| `COOKIE_PREFIX` | `anubis-cookie` | The prefix used for browser cookies created by Anubis. Useful for customization or avoiding conflicts with other applications. |\n| `COOKIE_SECURE` | `true` | If set to `true`, enables the [Secure flag](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/Cookies#block_access_to_your_cookies), meaning that the cookies will only be transmitted over HTTPS. If Anubis is used in an unsecure context (plain HTTP), this will be need to be set to false |\n| `COOKIE_SAME_SITE` | `None` | Controls the cookie’s [`SameSite` attribute](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Set-Cookie#samesitesamesite-value). Allowed: `None`, `Lax`, `Strict`, `Default`. `None` permits cross-site use but modern browsers require it to be **Secure**—so if `COOKIE_SECURE=false` or you serve over plain HTTP, use `Lax` (recommended) or `Strict` or the cookie will be rejected. `Default` uses the Go runtime’s `SameSiteDefaultMode`. `None` will be downgraded to `Lax` automatically if cookie is set NOT to be secure. |\n| `DIFFICULTY` | `4` | The difficulty of the challenge, or the number of leading zeroes that must be in successful responses. |\n| `DIFFICULTY_IN_JWT` | `false` | If set to `true`, adds the `difficulty` field into JWT claims, which indicates the difficulty the token has been generated. This may be useful for statistics and debugging. |\n| `ED25519_PRIVATE_KEY_HEX` | unset | The hex-encoded ed25519 private key used to sign Anubis responses. If this is not set, Anubis will generate one for you. This should be exactly 64 characters long. **Required when using persistent storage backends** (like bbolt) to ensure challenges survive service restarts. When running multiple instances on the same base domain, the key must be the same across all instances. See below for details. |\n| `ED25519_PRIVATE_KEY_HEX_FILE` | unset | Path to a file containing the hex-encoded ed25519 private key. Only one of this or its sister option may be set. **Required when using persistent storage backends** (like bbolt) to ensure challenges survive service restarts. When running multiple instances on the same base domain, the key must be the same across all instances. |\n| `ERROR_TITLE` | unset | <EO /> If set, override the translation stack to show a custom title for error pages such as \"Something went wrong!\". See [Customizing messages](./botstopper.mdx#customizing-messages) for more details. |\n| `JWT_RESTRICTION_HEADER` | `X-Real-IP` | If set, the JWT is only valid if the current value of this header matches the value when the JWT was created. You can use it e.g. to restrict a JWT to the source IP of the user using `X-Real-IP`. |\n| `METRICS_BIND` | `:9090` | The network address that Anubis serves Prometheus metrics on. See `BIND` for more information. |\n| `METRICS_BIND_NETWORK` | `tcp` | The address family that the Anubis metrics server listens on. See `BIND_NETWORK` for more information. |\n| `OG_EXPIRY_TIME` | `24h` | The expiration time for the Open Graph tag cache. Prefer using [the policy file](./configuration/open-graph.mdx) to configure the Open Graph subsystem. |\n| `OG_PASSTHROUGH` | `false` | If set to `true`, Anubis will enable Open Graph tag passthrough. Prefer using [the policy file](./configuration/open-graph.mdx) to configure the Open Graph subsystem. |\n| `OG_CACHE_CONSIDER_HOST` | `false` | If set to `true`, Anubis will consider the host in the Open Graph tag cache key. Prefer using [the policy file](./configuration/open-graph.mdx) to configure the Open Graph subsystem. |\n| `OVERLAY_FOLDER` | unset | <EO /> If set, treat the given path as an [overlay folder](./botstopper.mdx#custom-images-and-css), allowing you to customize CSS, fonts, images, and add other assets to BotStopper deployments. |\n| `POLICY_FNAME` | unset | The file containing [bot policy configuration](./policies.mdx). See the bot policy documentation for more details. If unset, the default bot policy configuration is used. |\n| `PUBLIC_URL` | unset | The externally accessible URL for this Anubis instance, used for constructing redirect URLs (e.g., for Traefik forwardAuth). Leave it unset when Anubis terminates traffic directly (sidecar/standalone deployments) or redirect building will fail with `redir=null`. |\n| `REDIRECT_DOMAINS` | unset | Comma-separated list of domain names that Anubis should allow redirects to when passing a challenge. See [Redirect Domain Configuration](./configuration/redirect-domains) for more details. |\n| `SERVE_ROBOTS_TXT` | `false` | If set `true`, Anubis will serve a default `robots.txt` file that disallows all known AI scrapers by name and then additionally disallows every scraper. This is useful if facts and circumstances make it difficult to change the underlying service to serve such a `robots.txt` file. |\n| `SLOG_LEVEL` | `INFO` | The log level for structured logging. Valid values are `DEBUG`, `INFO`, `WARN`, and `ERROR`. Set to `DEBUG` to see all requests, evaluations, and detailed diagnostic information. |\n| `SOCKET_MODE` | `0770` | _Only used when at least one of the `*_BIND_NETWORK` variables are set to `unix`._ The socket mode (permissions) for Unix domain sockets. |\n| `STRIP_BASE_PREFIX` | `false` | If set to `true`, strips the base prefix from request paths when forwarding to the target server. This is useful when your target service expects to receive requests without the base prefix. For example, with `BASE_PREFIX=/foo` and `STRIP_BASE_PREFIX=true`, a request to `/foo/bar` would be forwarded to the target as `/bar`. |\n| `TARGET` | `http://localhost:3923` | The URL of the service that Anubis should forward valid requests to. Supports Unix domain sockets, set this to a URI like so: `unix:///path/to/socket.sock`. |\n| `USE_REMOTE_ADDRESS` | unset | If set to `true`, Anubis will take the client's IP from the network socket. For production deployments, it is expected that a reverse proxy is used in front of Anubis, which pass the IP using headers, instead. |\n| `USE_SIMPLIFIED_EXPLANATION` | false | If set to `true`, replaces the text when clicking \"Why am I seeing this?\" with a more simplified text for a non-tech-savvy audience. |\n| `USE_TEMPLATES` | false | <EO /> If set to `true`, enable [custom HTML template support](./botstopper.mdx#custom-html-templates), allowing you to completely rewrite how BotStopper renders its HTML pages. |\n| `WEBMASTER_EMAIL` | unset | If set, shows a contact email address when rendering error pages. This email address will be how users can get in contact with administrators. |\n| `XFF_STRIP_PRIVATE` | `true` | If set, strip private addresses from `X-Forwarded-For` headers. To unset this, you must set `XFF_STRIP_PRIVATE=false` or `--xff-strip-private=false`. |\n\n<details>\n<summary>Advanced configuration settings</summary>\n\n:::note\n\nIf you don't know or understand what these settings mean, ignore them. These are intended to work around very specific issues.\n\n:::\n\n| Environment Variable | Default value | Explanation |\n| :---------------------------- | :------------ | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `FORCED_LANGUAGE` | unset | If set, forces Anubis to display challenge pages in the specified language instead of using the browser's Accept-Language header. Use ISO 639-1 language codes (e.g., `de` for German, `fr` for French). |\n| `HS512_SECRET` | unset | Secret string for JWT HS512 algorithm. If this is not set, Anubis will use ED25519 as defined via the variables above. The longer the better; 128 chars should suffice. **Required when using persistent storage backends** (like bbolt) to ensure challenges survive service restarts. When running multiple instances on the same base domain, the key must be the same across all instances. |\n| `TARGET_DISABLE_KEEPALIVE` | `false` | If `true`, disables HTTP keep-alive for connections to the target backend. Useful for backends that don't handle keep-alive properly. |\n| `TARGET_HOST` | unset | If set, overrides the Host header in requests forwarded to `TARGET`. |\n| `TARGET_INSECURE_SKIP_VERIFY` | `false` | If `true`, skip TLS certificate validation for targets that listen over `https`. If your backend does not listen over `https`, ignore this setting. |\n| `TARGET_SNI` | unset | If set, TLS handshake hostname when forwarding requests to the `TARGET`. If set to auto, use Host header. |\n\n</details>\n\nFor more detailed information on configuring Open Graph tags, please refer to the [Open Graph Configuration](./configuration/open-graph.mdx) page.\n\n### Using Base Prefix\n\nThe `BASE_PREFIX` environment variable allows you to run Anubis behind a path prefix. This is useful when:\n\n- You want to host multiple services on the same domain\n- You're using a reverse proxy that routes based on path prefixes\n- You need to integrate Anubis with an existing application structure\n\nFor example, if you set `BASE_PREFIX=/myapp`, Anubis will:\n\n- Serve its challenge page at `/myapp/` instead of `/`\n- Serve its API endpoints at `/myapp/.within.website/x/cmd/anubis/api/` instead of `/.within.website/x/cmd/anubis/api/`\n- Serve its static assets at `/myapp/.within.website/x/cmd/anubis/` instead of `/.within.website/x/cmd/anubis/`\n\nWhen using this feature with a reverse proxy:\n\n1. Configure your reverse proxy to route requests for the specified path prefix to Anubis\n2. Set the `BASE_PREFIX` environment variable to match the path prefix in your reverse proxy configuration\n3. Ensure that your reverse proxy preserves the path when forwarding requests to Anubis\n\nExample with Nginx:\n\n```nginx\nlocation /myapp/ {\n proxy_pass http://anubis:8923/myapp;\n proxy_set_header Host $host;\n proxy_set_header X-Real-IP $remote_addr;\n}\n```\n\nWith corresponding Anubis configuration:\n\n```\nBASE_PREFIX=/myapp\n```\n\n#### Stripping Base Prefix\n\nIf your target service doesn't expect to receive the base prefix in request paths, you can use the `STRIP_BASE_PREFIX` option:\n\n```\nBASE_PREFIX=/myapp\nSTRIP_BASE_PREFIX=true\n```\n\nWith this configuration:\n\n- A request to `/myapp/api/users` would be forwarded to your target service as `/api/users`\n- A request to `/myapp/` would be forwarded as `/`\n\nThis is particularly useful when working with applications that weren't designed to handle path prefixes. However, note that if your target application generates absolute redirects or links (like `/login` instead of `./login`), these may break the subpath routing since they won't include the base prefix.\n\n### Key generation\n\nTo generate an ed25519 private key, you can use this command:\n\n```text\nopenssl rand -hex 32\n```\n\nAlternatively here is a key generated by your browser:\n\n<RandomKey />\n\n## Next steps\n\nTo get Anubis filtering your traffic, you need to make sure it's added to your HTTP load balancer or platform configuration. See the [environments category](/docs/category/environments) for detailed information on individual environments.\n\n- [Apache](./environments/apache.mdx)\n- [Caddy](./environments/caddy.mdx)\n- [Docker compose](./environments/docker-compose.mdx)\n- [Kubernetes](./environments/kubernetes.mdx)\n- [Nginx](./environments/nginx.mdx)\n- [Traefik](./environments/traefik.mdx)\n- [HAProxy](./environments/haproxy.mdx)\n\n:::note\n\nAnubis loads its assets from `/.within.website/x/xess/` and `/.within.website/x/cmd/anubis`. If you do not reverse proxy these in your server config, Anubis won't work.\n\n:::\n"
},
{
"path": "docs/docs/admin/iplist2rule.mdx",
"content": "---\ntitle: iplist2rule CLI tool\n---\n\nThe `iplist2rule` tool converts IP blocklists into Anubis challenge policies. It reads common IP block list formats and generates the appropriate Anubis policy file for IP address filtering.\n\n## Installation\n\nInstall directly with Go\n\n```bash\ngo install github.com/TecharoHQ/anubis/utils/cmd/iplist2rule@latest\n```\n\n## Usage\n\nBasic conversion from URL:\n\n```bash\niplist2rule https://raw.githubusercontent.com/7c/torfilter/refs/heads/main/lists/txt/torfilter-1m-flat.txt filter-tor.yaml\n```\n\nExplicitly allow every IP address on a list:\n\n```bash\niplist2rule --action ALLOW https://raw.githubusercontent.com/7c/torfilter/refs/heads/main/lists/txt/torfilter-1m-flat.txt filter-tor.yaml\n```\n\nAdd weight to requests matching IP addresses on a list:\n\n```bash\niplist2rule --action WEIGH --weight 20 https://raw.githubusercontent.com/7c/torfilter/refs/heads/main/lists/txt/torfilter-1m-flat.txt filter-tor.yaml\n```\n\n## Options\n\n| Flag | Description | Default |\n| :------------ | :----------------------------------------------------------------------------------------------- | :-------------------------------- |\n| `--action` | The Anubis action to take for the IP address in question, must be in ALL CAPS. | `DENY` (forbids traffic) |\n| `--rule-name` | The name for the generated Anubis rule, should be in kebab-case. | (not set, inferred from filename) |\n| `--weight` | When `--action=WEIGH`, how many weight points should be added or removed from matching requests? | 0 (not set) |\n\n## Using the Generated Policy\n\nSave the output and import it in your main policy file:\n\n```yaml\nbots:\n - import: \"./filter-tor.yaml\"\n```\n"
},
{
"path": "docs/docs/admin/native-install.mdx",
"content": "---\ntitle: Installing Anubis with a native package\n---\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\nDownload the package for your system from [the most recent release on GitHub](https://github.com/TecharoHQ/anubis/releases).\n\nInstall the Anubis package using your package manager of choice:\n\n<Tabs>\n <TabItem value=\"deb\" label=\"Debian-based (apt)\" default>\n \nInstall Anubis with `apt`:\n\n```text\nsudo apt install ./anubis-$VERSION-$ARCH.deb\n```\n\n </TabItem>\n <TabItem value=\"tarball\" label=\"Tarball\">\n \nExtract the tarball to a folder:\n\n```text\ntar zxf ./anubis-$VERSION-$OS-$ARCH.tar.gz\ncd anubis-$VERSION-$OS-$ARCH\n```\n\nInstall the binary to your system:\n\n```text\nsudo install -D ./bin/anubis /usr/local/bin\n```\n\nEdit the systemd unit to point to `/usr/local/bin/anubis` instead of `/usr/bin/anubis`:\n\n```text\nperl -pi -e 's$/usr/bin/anubis$/usr/local/bin/anubis$g' ./run/anubis@.service\n```\n\nInstall the systemd unit to your system:\n\n```text\nsudo install -D ./run/anubis@.service /etc/systemd/system\n```\n\nInstall the default configuration file to your system:\n\n```text\nsudo install -D ./run/default.env /etc/anubis/default.env\n```\n\n </TabItem>\n <TabItem value=\"rpm\" label=\"Red Hat-based (rpm)\">\n \nInstall Anubis with `dnf`:\n\n```text\nsudo dnf -y install ./anubis-$VERSION.$ARCH.rpm\n```\n\nOR\n\nInstall Anubis with `yum`:\n\n```text\nsudo yum -y install ./anubis-$VERSION.$ARCH.rpm\n```\n\nOR\n\nInstall Anubis with `rpm`:\n\n```\nsudo rpm -ivh ./anubis-$VERSION.$ARCH.rpm\n```\n\n </TabItem>\n <TabItem value=\"distro\" label=\"Package managers\">\n\nSome Linux distributions offer Anubis [as a native package](https://repology.org/project/anubis-anti-crawler/versions). If you want to install Anubis from your distribution's package manager, consult any upstream documentation for how to install the package. It will either be named `anubis`, `www-apps/anubis` or `www/anubis`.\n\nIf you use a systemd-flavoured distribution, then follow the setup instructions for Debian or Red Hat Linux.\n\n </TabItem>\n</Tabs>\n\nOnce it's installed, make a copy of the default configuration file `/etc/anubis/default.env` based on which service you want to protect. For example, to protect a `gitea` server:\n\n```text\nsudo cp /etc/anubis/default.env /etc/anubis/gitea.env\n```\n\nCopy the default bot policies file to `/etc/anubis/gitea.botPolicies.yaml`:\n\n<Tabs>\n<TabItem value=\"debrpm\" label=\"Debian or Red Hat\" default>\n\n```text\nsudo cp /usr/share/doc/anubis/botPolicies.yaml /etc/anubis/gitea.botPolicies.yaml\n```\n\n</TabItem>\n<TabItem value=\"tarball\" label=\"Tarball\">\n\n```text\nsudo cp ./doc/botPolicies.yaml /etc/anubis/gitea.botPolicies.yaml\n```\n\n</TabItem>\n\n</Tabs>\n\nThen open `gitea.env` in your favorite text editor and customize [the environment variables](./installation.mdx#environment-variables) as needed. Here's an example configuration for a Gitea server:\n\n```sh\nBIND=[::1]:8239\nBIND_NETWORK=tcp\nDIFFICULTY=4\nMETRICS_BIND=[::1]:8240\nMETRICS_BIND_NETWORK=tcp\nPOLICY_FNAME=/etc/anubis/gitea.botPolicies.yaml\nTARGET=http://localhost:3000\n```\n\nThen start Anubis with `systemctl enable --now`:\n\n```text\nsudo systemctl enable --now anubis@gitea.service\n```\n\nTest to make sure it's running with `curl`:\n\n```text\ncurl http://localhost:8240/metrics\n```\n\nThen set up your reverse proxy (Nginx, Caddy, etc.) to point to the Anubis port. Anubis will then reverse proxy all requests that meet the policies in `/etc/anubis/gitea.botPolicies.yaml` to the target service.\n\nFor more details on particular reverse proxies, see here:\n\n- [Apache](./environments/apache.mdx)\n- [Nginx](./environments/nginx.mdx)\n- [HAProxy](./environments/haproxy.mdx)\n"
},
{
"path": "docs/docs/admin/policies.mdx",
"content": "---\ntitle: Policy Definitions\n---\n\nimport Tabs from \"@theme/Tabs\";\nimport TabItem from \"@theme/TabItem\";\n\nOut of the box, Anubis is pretty heavy-handed. It will aggressively challenge everything that might be a browser (usually indicated by having `Mozilla` in its user agent). However, some bots are smart enough to get past the challenge. Some things that look like bots may actually be fine (IE: RSS readers). Some resources need to be visible no matter what. Some resources and remotes are fine to begin with.\n\nAnubis lets you customize its configuration with a Policy File. This is a YAML document that spells out what actions Anubis should take when evaluating requests. The [default configuration](https://github.com/TecharoHQ/anubis/blob/main/data/botPolicies.yaml) explains everything, but this page contains an overview of everything you can do with it.\n\n## Bot Policies\n\nBot policies let you customize the rules that Anubis uses to allow, deny, or challenge incoming requests. Currently you can set policies by the following matches:\n\n- Request path\n- User agent string\n- HTTP request header values\n- [Importing other configuration snippets](./configuration/import.mdx)\n\nAs of version v1.17.0 or later, configuration can be written in either JSON or YAML.\n\nHere's an example rule that denies [Amazonbot](https://developer.amazon.com/en/amazonbot):\n\n```yaml\n- name: amazonbot\n user_agent_regex: Amazonbot\n action: DENY\n```\n\nWhen this rule is evaluated, Anubis will check the `User-Agent` string of the request. If it contains `Amazonbot`, Anubis will send an error page to the user saying that access is denied, but in such a way that makes scrapers think they have correctly loaded the webpage.\n\nRight now the only kinds of policies you can write are bot policies. Other forms of policies will be added in the future.\n\nHere is a minimal policy file that will protect against most scraper bots:\n\n```yaml\nbots:\n - name: cloudflare-workers\n headers_regex:\n CF-Worker: .*\n action: DENY\n - name: well-known\n path_regex: ^/.well-known/.*$\n action: ALLOW\n - name: favicon\n path_regex: ^/favicon.ico$\n action: ALLOW\n - name: robots-txt\n path_regex: ^/robots.txt$\n action: ALLOW\n - name: generic-browser\n user_agent_regex: Mozilla\n action: CHALLENGE\n```\n\nThis allows requests to [`/.well-known`](https://en.wikipedia.org/wiki/Well-known_URI), `/favicon.ico`, `/robots.txt`, and challenges any request that has the word `Mozilla` in its User-Agent string. The [default policy file](https://github.com/TecharoHQ/anubis/blob/main/data/botPolicies.yaml) is a bit more cohesive, but this should be more than enough for most users.\n\nIf no rules match the request, it is allowed through. For more details on this default behavior and its implications, see [Default allow behavior](./default-allow-behavior.mdx).\n\n### Writing your own rules\n\nThere are four actions that can be returned from a rule:\n\n| Action | Effects |\n| :---------- | :---------------------------------------------------------------------------------------------------------------------------------- |\n| `ALLOW` | Bypass all further checks and send the request to the backend. |\n| `DENY` | Deny the request and send back an error message that scrapers think is a success. |\n| `CHALLENGE` | Show a challenge page and/or validate that clients have passed a challenge. |\n| `WEIGH` | Change the [request weight](#request-weight) for this request. See the [request weight](#request-weight) docs for more information. |\n\nName your rules in lower case using kebab-case. Rule names will be exposed in Prometheus metrics.\n\n### Challenge configuration\n\nRules can also have their own challenge settings. These are customized using the `\"challenge\"` key. For example, here is a rule that makes challenges artificially hard for connections with the substring \"bot\" in their user agent:\n\nThis rule has been known to have a high false positive rate in testing. Please use this with care.\n\n```yaml\n# Punish any bot with \"bot\" in the user-agent string\n- name: generic-bot-catchall\n user_agent_regex: (?i:bot|crawler)\n action: CHALLENGE\n challenge:\n difficulty: 16 # impossible\n algorithm: slow # intentionally waste CPU cycles and time\n```\n\nChallenges can be configured with these settings:\n\n| Key | Example | Description |\n| :----------- | :------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `difficulty` | `4` | The challenge difficulty (number of leading zeros) for proof-of-work. See [Why does Anubis use Proof-of-Work?](/docs/design/why-proof-of-work) for more details. |\n| `algorithm` | `\"fast\"` | The challenge method to use. See [the list of challenge methods](./configuration/challenges/) for more information. |\n\n### Remote IP based filtering\n\nThe `remote_addresses` field of a Bot rule allows you to set the IP range that this ruleset applies to.\n\nFor example, you can allow a search engine to connect if and only if its IP address matches the ones they published:\n\n```yaml\n- name: qwantbot\n user_agent_regex: \\+https\\://help\\.qwant\\.com/bot/\n action: ALLOW\n # https://help.qwant.com/wp-content/uploads/sites/2/2025/01/qwantbot.json\n remote_addresses: [\"91.242.162.0/24\"]\n```\n\nThis also works at an IP range level without any other checks:\n\n```yaml\nname: internal-network\naction: ALLOW\nremote_addresses:\n - 100.64.0.0/10\n```\n\n## Imprint / Impressum support\n\nAnubis has support for showing imprint / impressum information. This is defined in the `impressum` block of your configuration. See [Imprint / Impressum configuration](./configuration/impressum.mdx) for more information.\n\n## Storage backends\n\nAnubis needs to store temporary data in order to determine if a user is legitimate or not. Administrators should choose a storage backend based on their infrastructure needs. Each backend has its own advantages and disadvantages.\n\nAnubis offers the following storage backends:\n\n- [`memory`](#memory) -- A simple in-memory hashmap\n- [`bbolt`](#bbolt) -- An on-disk key/value store backed by [bbolt](https://github.com/etcd-io/bbolt), an embedded key/value database for Go programs\n- [`valkey`](#valkey) -- A remote in-memory key/value database backed by [Valkey](https://valkey.io/) (or another database compatible with the [RESP](https://redis.io/docs/latest/develop/reference/protocol-spec/) protocol)\n\nIf no storage backend is set in the policy file, Anubis will use the [`memory`](#memory) backend by default. This is equivalent to the following in the policy file:\n\n```yaml\nstore:\n backend: memory\n parameters: {}\n```\n\n### `memory`\n\nThe memory backend is an in-memory cache. This backend works best if you don't use multiple instances of Anubis or don't have mutable storage in the environment you're running Anubis in.\n\n| Should I use this backend? | Yes/no |\n| :------------------------------------------------------------ | :----- |\n| Are you running only one instance of Anubis for this service? | ✅ Yes |\n| Does your service get a lot of traffic? | 🚫 No |\n| Do you want to store data persistently when Anubis restarts? | 🚫 No |\n| Do you run Anubis without mutable filesystem storage? | ✅ Yes |\n\nThe biggest downside is that there is not currently a limit to how much data can be stored in memory. This will be addressed at a later time.\n\n:::warning\n\nThe in-memory backend exists mostly for validation, testing, and to ensure that the default configuration of Anubis works as expected. Do not use this persistently in production.\n\n:::\n\n#### Configuration\n\nThe memory backend does not require any configuration to use.\n\n### `bbolt`\n\nAn on-disk storage layer powered by [bbolt](https://github.com/etcd-io/bbolt), a high performance embedded key/value database used by containerd, etcd, Kubernetes, and NATS. This backend works best if you're running Anubis on a single host and get a lot of traffic.\n\n| Should I use this backend? | Yes/no |\n| :------------------------------------------------------------ | :----- |\n| Are you running only one instance of Anubis for this service? | ✅ Yes |\n| Does your service get a lot of traffic? | ✅ Yes |\n| Do you want to store data persistently when Anubis restarts? | ✅ Yes |\n| Do you run Anubis without mutable filesystem storage? | 🚫 No |\n\nWhen Anubis opens a bbolt database, it takes an exclusive lock on that database. Other instances of Anubis or other tools cannot view the bbolt database while it is locked by another instance of Anubis. If you run multiple instances of Anubis for different services, give each its own `bbolt` configuration.\n\n#### Configuration\n\nThe `bbolt` backend takes the following configuration options:\n\n| Name | Type | Example | Description |\n| :----- | :--- | :----------------- | :--------------------------------------------------------------------------------------------------------------------------- |\n| `path` | path | `/data/anubis.bdb` | The filesystem path for the Anubis bbolt database. Anubis requires write access to the folder containing the bbolt database. |\n\nExample:\n\nIf you have persistent storage mounted to `/data`, then your store configuration could look like this:\n\n```yaml\nstore:\n backend: bbolt\n parameters:\n path: /data/anubis.bdb\n```\n\n### `s3api`\n\nA network-backed storage layer backed by [object storage](https://en.wikipedia.org/wiki/Object_storage), specifically using the [S3 API](https://docs.aws.amazon.com/AmazonS3/latest/API/Type_API_Reference.html). This can be backed by any S3-compatible object storage service such as:\n\n- [AWS S3](https://aws.amazon.com/s3/)\n- [Cloudflare R2](https://www.cloudflare.com/developer-platform/products/r2/)\n- [Hetzner Object Storage](https://www.hetzner.com/storage/object-storage/)\n- [Minio](https://www.min.io/)\n- [Tigris](https://www.tigrisdata.com/)\n\nIf you are using a cloud platform, they likely provide an S3 compatible object storage service. If not, you may want to choose [one of the fastest options](https://www.tigrisdata.com/blog/benchmark-small-objects/).\n\n| Should I use this backend? | Yes/no |\n| :------------------------------------------------------------ | :----- |\n| Are you running only one instance of Anubis for this service? | 🚫 No |\n| Does your service get a lot of traffic? | ✅ Yes |\n| Do you want to store data persistently when Anubis restarts? | ✅ Yes |\n| Do you run Anubis without mutable filesystem storage? | ✅ Yes |\n\n:::note\n\nUsing this backend will cause a lot of S3 operations, at least one for creating challenges, one for invalidating challenges, one for updating challenges to prevent double-spends, and one for removing challenges.\n\n:::\n\n#### Configuration\n\nThe `s3api` backend takes the following configuration options:\n\n| Name | Type | Example | Description |\n| :----------- | :------ | :------------ | :------------------------------------------------------------------------------------------------------------------------------------------ |\n| `bucketName` | string | `anubis-data` | (Required) The name of the dedicated bucket for Anubis to store information in. |\n| `pathStyle` | boolean | `false` | If true, use path-style S3 API operations. Please consult your storage provider's documentation if you don't know what you should put here. |\n\n:::note\n\nYou should probably enable a lifecycle expiration rule for buckets containing Anubis data. Here is an example policy:\n\n```json\n{\n \"Rules\": [\n {\n \"Status\": \"Enabled\",\n \"Expiration\": {\n \"Days\": 7\n }\n }\n ]\n}\n```\n\nAdjust this as facts and circumstances demand, but 7 days should be enough for anyone.\n\n:::\n\nExample:\n\nAssuming your environment looks like this:\n\n```sh\n# All of the following are fake credentials that look like real ones.\nAWS_ACCESS_KEY_ID=accordingToAllKnownRulesOfAviation\nAWS_SECRET_ACCESS_KEY=thereIsNoWayABeeShouldBeAbleToFly\nAWS_REGION=yow\nAWS_ENDPOINT_URL_S3=https://yow.s3.probably-not-malware.lol\n```\n\nThen your configuration would look like this:\n\n```yaml\nstore:\n backend: s3api\n parameters:\n bucketName: techaro-prod-anubis\n pathStyle: false\n```\n\n### `valkey`\n\n[Valkey](https://valkey.io/) is an in-memory key/value store that clients access over the network. This allows multiple instances of Anubis to share information and does not require each instance of Anubis to have persistent filesystem storage.\n\n:::note\n\nYou can also use [Redis™](http://redis.io/) with Anubis.\n\n:::\n\nThis backend is ideal if you are running multiple instances of Anubis in a worker pool (eg: Kubernetes Deployments with a copy of Anubis in each Pod).\n\n| Should I use this backend? | Yes/no |\n| :------------------------------------------------------------ | :----- |\n| Are you running only one instance of Anubis for this service? | 🚫 No |\n| Does your service get a lot of traffic? | ✅ Yes |\n| Do you want to store data persistently when Anubis restarts? | ✅ Yes |\n| Do you run Anubis without mutable filesystem storage? | ✅ Yes |\n| Do you have Redis™ or Valkey installed? | ✅ Yes |\n\n#### Configuration\n\nThe `valkey` backend takes the following configuration options:\n\n| Name | Type | Example | Description |\n| :--------- | :----- | :---------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------ |\n| `cluster` | bool | `false` | If true, use [Redis™ Clustering](https://redis.io/topics/cluster-spec) for storing Anubis data. |\n| `sentinel` | object | `{}` | See [Redis™ Sentinel docs](#redis-sentinel) for more detail and examples |\n| `url` | string | `redis://valkey:6379/0` | The URL for the instance of Redis™ or Valkey that Anubis should store data in. This is in the same format as `REDIS_URL` in many cloud providers. |\n\nExample:\n\nIf you have an instance of Valkey running with the hostname `valkey.int.techaro.lol`, then your store configuration could look like this:\n\n```yaml\nstore:\n backend: valkey\n parameters:\n url: \"redis://valkey.int.techaro.lol:6379/0\"\n```\n\nThis would have the Valkey client connect to host `valkey.int.techaro.lol` on port `6379` with database `0` (the default database).\n\n#### Redis™ Sentinel\n\nIf you are using [Redis™ Sentinel](https://redis.io/docs/latest/operate/oss_and_stack/management/sentinel/) for a high availability setup, you need to configure the `sentinel` object. This object takes the following configuration options:\n\n| Name | Type | Example | Description |\n| :----------- | :----------------------- | :-------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `addr` | string or list of string | `10.43.208.130:26379` | (Required) The host and port of the Redis™ Sentinel server. When possible, use DNS names for this. If you have multiple addresses, supply a list of them. |\n| `clientName` | string | `Anubis` | The client name reported to Redis™ Sentinel. Set this if you want to track Anubis connections to your Redis™ Sentinel. |\n| `masterName` | string | `mymaster` | (Required) The name of the master in the Redis™ Sentinel configuration. This is used to discover where to find client connection hosts/ports. |\n| `username` | string | `azurediamond` | The username used to authenticate against the Redis™ Sentinel and Redis™ servers. |\n| `password` | string | `hunter2` | The password used to authenticate against the Redis™ Sentinel and Redis™ servers. |\n\n## Logging management\n\nAnubis has very verbose logging out of the box. This is intentional and allows administrators to be sure that it is working merely by watching it work in real time. Some administrators may not appreciate this level of logging out of the box. As such, Anubis lets you customize details about how it logs data.\n\nAnubis uses a practice called [structured logging](https://stackify.com/what-is-structured-logging-and-why-developers-need-it/) to emit log messages with key-value pair context. In order to make analyzing large amounts of log messages easier, Anubis encodes all logs in JSON. This allows you to use any tool that can parse JSON to perform analytics or monitor for issues.\n\nAnubis exposes the following logging settings in the policy file:\n\n| Name | Type | Example | Description |\n| :----------- | :----------------------- | :-------------- | :--------------------------------------------------------------------------------------------------------------------------------------- |\n| `level` | [log level](#log-levels) | `info` | The logging level threshold. Any logs that are at or above this threshold will be drained to the sink. Any other logs will be discarded. |\n| `sink` | string | `stdio`, `file` | The sink where the logs drain to as they are being recorded in Anubis. |\n| `parameters` | object | | Parameters for the given logging sink. This will vary based on the logging sink of choice. See below for more information. |\n\nAnubis supports the following logging sinks:\n\n1. `file`: logs are emitted to a file that is rotated based on size and age. Old log files are compressed with gzip to save space. This allows for better integration with users that decide to use legacy service managers (OpenRC, FreeBSD's init, etc).\n2. `stdio`: logs are emitted to the standard error stream of the Anubis process. This allows runtimes such as Docker, Podman, Systemd, and Kubernetes to capture logs with their native logging subsystems without any additional configuration.\n\n### Log levels\n\nAnubis uses Go's [standard library `log/slog` package](https://pkg.go.dev/log/slog) to emit structured logs. By default, Anubis logs at the [Info level](https://pkg.go.dev/log/slog#Level), which is fairly verbose out of the box. Here are the possible logging levels in Anubis:\n\n| Log level | Use in Anubis |\n| :-------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `DEBUG` | The raw unfiltered torrent of doom. Only use this if you are actively working on Anubis or have very good reasons to use it. |\n| `INFO` | The default logging level, fairly verbose in order to make it easier for automation to parse. |\n| `WARN` | A \"more silent\" logging level. Much less verbose. Some things that are now at the `info` level need to be moved up to the `warn` level in future patches. |\n| `ERROR` | Only log error messages. |\n\nAdditionally, you can set a \"slightly higher\" log level if you need to, such as:\n\n```yaml\nlogging:\n sink: stdio\n level: \"INFO+1\"\n```\n\nThis isn't currently used by Anubis, but will be in the future for \"slightly important\" information.\n\n### `file` sink\n\nThe `file` sink makes Anubis write its logs to the filesystem and rotate them out when the log file meets certain thresholds. This logging sink takes the following parameters:\n\n| Name | Type | Example | Description |\n| :------------- | :-------------- | :-------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `file` | string | `/var/log/anubis.log` | The file where Anubis logs should be written to. Make sure the user Anubis is running as has write and file creation permissions to this directory. |\n| `maxBackups` | number | `3` | The number of old log files that should be maintained when log files are rotated out. |\n| `maxBytes` | number of bytes | `67108864` (64Mi) | The maximum size of each log file before it is rotated out. |\n| `maxAge` | number of days | `7` | If a log file is more than this many days old, rotate it out. |\n| `compress` | boolean | `true` | If true, compress old log files with gzip. This should be set to `true` and is only exposed as an option for dealing with legacy workflows where there is magical thinking about log files at play. |\n| `useLocalTime` | boolean | `false` | If true, use the system local time zone to create log filenames instead of UTC. This should almost always be set to `false` and is only exposed for legacy workflows where there is magical thinking about time zones at play. |\n\n```yaml\nlogging:\n sink: file\n parameters:\n file: \"./var/anubis.log\"\n maxBackups: 3 # keep at least 3 old copies\n maxBytes: 67108864 # each file can have up to 64 Mi of logs\n maxAge: 7 # rotate files out every n days\n compress: true # gzip-compress old log files\n useLocalTime: false # timezone for rotated files is UTC\n```\n\nWhen files are rotated out, the old files will be named after the rotation timestamp in [RFC 3339 format](https://www.rfc-editor.org/rfc/rfc3339).\n\n:::note\n\nIf you are running Anubis in systemd via a native package, the default systemd unit settings are very restrictive and will forbid writing to folders in `/var/log`. In order to fix this, please make a [drop-in unit](https://www.flatcar.org/docs/latest/setup/systemd/drop-in-units/) like the following:\n\n```text\n# /etc/systemd/anubis@instance-name.service.d/50-var-log-readwrite.conf\n[Service]\nReadWritePaths=/run /var/log/anubis\n```\n\nOnce you write this to the correct place, reload the systemd configuration:\n\n```text\nsudo systemctl daemon-reload\n```\n\nAnd then restart Anubis:\n\n```text\nsudo systemctl restart anubis@instance-name\n```\n\nYou may be required to make drop-ins for each Anubis instance depending on the facts and circumstances of your deployment.\n\n:::\n\n### `stdio` sink\n\nBy default, Anubis logs everything to the standard error stream of its process. This requires no configuration:\n\n```yaml\nlogging:\n sink: stdio\n```\n\nIf you use a service orchestration platform that does not capture the standard error stream of processes, you need to use a different logging sink.\n\n## Risk calculation for downstream services\n\nIn case your service needs it for risk calculation reasons, Anubis exposes information about the rules that any requests match using a few headers:\n\n| Header | Explanation | Example |\n| :---------------- | :--------------------------------------------------- | :--------------- |\n| `X-Anubis-Rule` | The name of the rule that was matched | `bot/lightpanda` |\n| `X-Anubis-Action` | The action that Anubis took in response to that rule | `CHALLENGE` |\n| `X-Anubis-Status` | The status and how strict Anubis was in its checks | `PASS` |\n\nPolicy rules are matched using [Go's standard library regular expressions package](https://pkg.go.dev/regexp). You can mess around with the syntax at [regex101.com](https://regex101.com), make sure to select the Golang option.\n\n## Request Weight\n\nAnubis rules can also add or remove \"weight\" from requests, allowing administrators to configure custom levels of suspicion. For example, if your application uses session tokens named `i_love_gitea`:\n\n```yaml\n- name: gitea-session-token\n action: WEIGH\n expression:\n all:\n - '\"Cookie\" in headers'\n - headers[\"Cookie\"].contains(\"i_love_gitea=\")\n # Remove 5 weight points\n weight:\n adjust: -5\n```\n\nThis would remove five weight points from the request, which would make Anubis present the [Meta Refresh challenge](./configuration/challenges/metarefresh.mdx) in the default configuration.\n\n### Weight Thresholds\n\nFor more information on configuring weight thresholds, see [Weight Threshold Configuration](./configuration/thresholds.mdx)\n\n### Advice\n\nWeight is still very new and needs work. This is an experimental feature and should be treated as such. Here's some advice to help you better tune requests:\n\n- The default weight for browser-like clients is 10. This triggers an aggressive challenge.\n- Remove and add weight in multiples of five.\n- Be careful with how you configure weight.\n"
},
{
"path": "docs/docs/admin/robots2policy.mdx",
"content": "---\ntitle: robots2policy CLI Tool\nsidebar_position: 50\n---\n\nThe `robots2policy` tool converts robots.txt files into Anubis challenge policies. It reads robots.txt rules and generates equivalent CEL expressions for path matching and user-agent filtering.\n\n## Installation\n\nInstall directly with Go:\n\n```bash\ngo install github.com/TecharoHQ/anubis/cmd/robots2policy@latest\n```\n\n## Usage\n\nBasic conversion from URL:\n\n```bash\nrobots2policy -input https://www.example.com/robots.txt\n```\n\nConvert local file to YAML:\n\n```bash\nrobots2policy -input robots.txt -output policy.yaml\n```\n\nConvert with custom settings:\n\n```bash\nrobots2policy -input robots.txt -action DENY -format json\n```\n\n## Options\n\n| Flag | Description | Default |\n| --------------------- | ------------------------------------------------------------------ | ------------------- |\n| `-input` | robots.txt file path or URL (use `-` for stdin) | _required_ |\n| `-output` | Output file (use `-` for stdout) | stdout |\n| `-format` | Output format: `yaml` or `json` | `yaml` |\n| `-action` | Action for disallowed paths: `ALLOW`, `DENY`, `CHALLENGE`, `WEIGH` | `CHALLENGE` |\n| `-name` | Policy name prefix | `robots-txt-policy` |\n| `-crawl-delay-weight` | Weight adjustment for crawl-delay rules | `3` |\n| `-deny-user-agents` | Action for blacklisted user agents | `DENY` |\n\n## Example\n\nInput robots.txt:\n\n```txt\nUser-agent: *\nDisallow: /admin/\nDisallow: /private\n\nUser-agent: BadBot\nDisallow: /\n```\n\nGenerated policy:\n\n```yaml\n- name: robots-txt-policy-disallow-1\n action: CHALLENGE\n expression:\n single: path.startsWith(\"/admin/\")\n- name: robots-txt-policy-disallow-2\n action: CHALLENGE\n expression:\n single: path.startsWith(\"/private\")\n- name: robots-txt-policy-blacklist-3\n action: DENY\n expression:\n single: userAgent.contains(\"BadBot\")\n```\n\n## Using the Generated Policy\n\nSave the output and import it in your main policy file:\n\n```yaml\nbots:\n - import: \"./robots-policy.yaml\"\n```\n\nThe tool handles wildcard patterns, user-agent specific rules, and blacklisted bots automatically.\n"
},
{
"path": "docs/docs/admin/roles/_category_.json",
"content": "{\n \"label\": \"Server Roles\",\n \"position\": 40,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Various server roles you will need to keep in mind with Anubis.\"\n }\n}\n"
},
{
"path": "docs/docs/admin/roles/oci-registry.mdx",
"content": "# OCI Registries\n\nIf you are serving an OCI registry behind Anubis, you will need to import the `(data)/clients/docker-client.yaml` file in order to make sure that OCI registry clients can download images:\n\n```yaml\nbots:\n - import: (data)/meta/default-config.yaml\n - import: (data)/clients/docker-client.yaml\n# ... the rest of your config\n```\n"
},
{
"path": "docs/docs/admin/thoth.mdx",
"content": "# Thoth-based advanced checks\n\nStatus: Beta\n\nAnubis instances are normally isolated. Each Anubis instance has its own configuration and exists in roughly its own world without any long term memory between requests. As threats, workarounds, and AI scraper toolchains evolve, administrators will need a way to get more up to date information faster than Anubis' release cycle.\n\nThus, Thoth is being created. Thoth is the reputation database for Anubis. Thoth feeds information to Anubis so that it can make better decisions about which traffic is innocuous and which traffic is suspicious.\n\n:::note\n\nThoth is hosted by [Techaro](https://techaro.lol). Thoth is a paid service. Thoth is opt-in and requires manual intervention (including payment) to use. The code that powers Thoth is currently closed source.\n\nTo get access to Thoth, please subscribe [on GitHub Sponsors](https://github.com/sponsors/Xe) and [email Xe](mailto:xe@techaro.lol). This will be self-service soon.\n\n:::\n\n## Implementation\n\nThoth is a web service that listens over [gRPC](https://grpc.io/). Thoth's API is documented in protocol buffer definitions in the GitHub repo [TecharoHQ/thoth-proto](https://github.com/TecharoHQ/thoth-proto).\n\nThoth is designed to be _informative_, not _authoritative_. Thoth cannot and will not arbitrarily block requests, origins, or other traffic. Thoth is there to inform Anubis and influence the weight of requests so that upstream resources can be protected. Additionally, Anubis aggressively caches data from Thoth such that over time Anubis will not need to request data very often. This makes the fast path for repeat visitors even faster and reduces the amount of data that Thoth is exposed to.\n\n## Thoth features\n\nThoth is currently in active development. Currently, Thoth provides the following features to Anubis:\n\n- BGP Autonomous System (ASN) based filtering\n- GeoIP location based filtering\n\n### ASN-based filtering\n\nWhen companies link their backbone infrastructure to the Internet, they do so via a [BGP Autonomous System](<https://en.wikipedia.org/wiki/Autonomous_system_(Internet)>), denoted by a number (the Autonomous System Number or ASN). Every IP address on the Internet is owned by an ASN with a 1:1 lookup that does not change very frequently.\n\nAnubis uses Thoth to match IP addresses to BGP Autonomous Systems so that you can either issue arbitrary challenges to individual internet service providers (such as Cloudflare or Huawei Cloud) or, at the administrator's explicit instruction, block them altogether. For example, here's how you add 10 weight points to requests from Cloudflare, Huawei Cloud, and Alibaba Cloud:\n\n```yaml\n- name: aggressive-asns-without-functional-abuse-contact\n action: WEIGH\n asns:\n match:\n - 13335 # Cloudflare\n - 136907 # Huawei Cloud\n - 45102 # Alibaba Cloud\n weight:\n adjust: 10\n```\n\nYou can look up details for [AS13335](https://bgp.tools/as/13335) or any of these other top offenders on [bgp.tools](https://bgp.tools).\n\n### GeoIP-based filtering\n\nIn extreme cases, an administrator may have to take action against an entire country. This is not an ideal circumstance, but sometimes reality forces their hands and the administrators just want to sleep at night.\n\nAnubis uses Thoth to look up the geographic location registered to an IP address. This lookup is not the best and will get better with time, but you ship what you can so you can make it better for next time.\n\nFor example, to add 10 weight points to requests from Brazil and China:\n\n```yaml\n- name: countries-with-aggressive-scrapers\n action: WEIGH\n geoip:\n countries:\n - BR\n - CN\n weight:\n adjust: 10\n```\n\nUse this with care.\n\n## Work-in-progress features\n\nThis section is a bit aspirational and is where Thoth will end up rather than things you can use today.\n\nIn general, a lot of Thoth features are focused on taking the same Anubis you know and love and making it better, smarter, and less paranoid. These include:\n\n- Private rulesets for advanced patterns, current known exploits, and other recognition tactics that need to be kept cloak and dagger for operational security reasons\n- Private challenge implementations via WebAssembly, including advanced browser detection logic\n- Reputation querying so that Thoth can arbitrarily influence the weight of requests based on the net aggregate pass rate so that the most common browsers can get through with no challenge issued at all\n- APIs for trusted administrators to report abusive request fingerprints so that Anubis can react to threats as they evolve\n- A way for Anubis to periodically report the pass rate per ASN and other fingerprints so that methodology can be improved\n"
},
{
"path": "docs/docs/design/_category_.json",
"content": "{\n \"label\": \"Design\",\n \"position\": 10,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"How Anubis is designed and the tradeoffs it makes.\"\n }\n}\n"
},
{
"path": "docs/docs/design/how-anubis-works.mdx",
"content": "---\ntitle: How Anubis works\n---\n\nAnubis uses a proof-of-work challenge to ensure that clients are using a modern browser and are able to calculate SHA-256 checksums. Anubis has a customizable difficulty for this proof-of-work challenge, but defaults to 5 leading zeroes.\n\n```mermaid\n---\ntitle: Challenge generation and validation\n---\n\nflowchart TD\n Backend(\"Backend\")\n Fail(\"Fail\")\n\n style PresentChallenge color:#FFFFFF, fill:#AA00FF, stroke:#AA00FF\n style ValidateChallenge color:#FFFFFF, fill:#AA00FF, stroke:#AA00FF\n style Backend color:#FFFFFF, stroke:#00C853, fill:#00C853\n style Fail color:#FFFFFF, stroke:#FF2962, fill:#FF2962\n\n subgraph Server\n PresentChallenge(\"Present Challenge\")\n ValidateChallenge(\"Validate Challenge\")\n end\n\n subgraph Client\n Main(\"main.mjs\")\n Worker(\"Worker\")\n end\n\n Main -- Request challenge --> PresentChallenge\n PresentChallenge -- Return challenge & difficulty --> Main\n Main -- Spawn worker --> Worker\n Worker -- Successful challenge --> Main\n Main -- Validate challenge --> ValidateChallenge\n ValidateChallenge -- Return cookie --> Backend\n ValidateChallenge -- If anything is wrong --> Fail\n```\n\n## Challenge presentation\n\nAnubis decides to present a challenge using this logic:\n\n- User-Agent contains `\"Mozilla\"`\n- Request path is not in `/.well-known`, `/robots.txt`, or `/favicon.ico`\n- Request path is not obviously an RSS feed (ends with `.rss`, `.xml`, or `.atom`)\n\nThis should ensure that git clients, RSS readers, and other low-harm clients can get through without issue, but high-risk clients such as browsers and AI scraper bots will get blocked.\n\n```mermaid\n---\ntitle: Challenge presentation logic\n---\n\nflowchart LR\n Request(\"Request\")\n Backend(\"Backend\")\n %%Fail(\"Fail\")\n PresentChallenge(\"Present\nchallenge\")\n HasMozilla{\"Is browser\nor scraper?\"}\n HasCookie{\"Has cookie?\"}\n HasExpired{\"Cookie expired?\"}\n HasSignature{\"Has valid\nsignature?\"}\n RandomJitter{\"Secondary\nscreening?\"}\n POWPass{\"Proof of\nwork valid?\"}\n\n style PresentChallenge color:#FFFFFF, fill:#AA00FF, stroke:#AA00FF\n style Backend color:#FFFFFF, stroke:#00C853, fill:#00C853\n %%style Fail color:#FFFFFF, stroke:#FF2962, fill:#FF2962\n\n Request --> HasMozilla\n HasMozilla -- Yes --> HasCookie\n HasMozilla -- No --> Backend\n HasCookie -- Yes --> HasExpired\n HasCookie -- No --> PresentChallenge\n HasExpired -- Yes --> PresentChallenge\n HasExpired -- No --> HasSignature\n HasSignature -- Yes --> RandomJitter\n HasSignature -- No --> PresentChallenge\n RandomJitter -- Yes --> POWPass\n RandomJitter -- No --> Backend\n POWPass -- Yes --> Backend\n PowPass -- No --> PresentChallenge\n PresentChallenge -- Back again for another cycle --> Request\n```\n\n## Proof of passing challenges\n\nWhen a client passes a challenge, Anubis sets an HTTP cookie named `\"techaro.lol-anubis-auth\"` containing a signed [JWT](https://jwt.io/) (JSON Web Token). This JWT contains the following claims:\n\n- `challenge`: The challenge string derived from user request metadata\n- `nonce`: The nonce / iteration number used to generate the passing response\n- `response`: The hash that passed Anubis' checks\n- `iat`: When the token was issued\n- `nbf`: One minute prior to when the token was issued\n- `exp`: The token's expiry week after the token was issued\n\nThis ensures that the token has enough metadata to prove that the token is valid (due to the token's signature), but also so that the server can independently prove the token is valid. This cookie is allowed to be set without triggering an EU cookie banner notification; but depending on facts and circumstances, you may wish to disclose this to your users.\n\n## JWT signing\n\nAnubis uses an ed25519 keypair to sign the JWTs issued when challenges are passed. Anubis will generate a new ed25519 keypair every time it starts. At this time, there is no way to share this keypair between instance of Anubis, but that will be addressed in future versions.\n"
},
{
"path": "docs/docs/design/why-proof-of-work.mdx",
"content": "---\ntitle: Why does Anubis use Proof-of-Work?\n---\n\nAnubis uses [proof of work](https://en.wikipedia.org/wiki/Proof_of_work) in order to validate that clients are genuine. The reason Anubis does this was inspired by [Hashcash](https://en.wikipedia.org/wiki/Hashcash), a suggestion from the early 2000's about extending the email protocol to avoid spam. The idea is that genuine people sending emails will have to do a small math problem that is expensive to compute, but easy to verify such as hashing a string with a given number of leading zeroes. This will have basically no impact on individuals sending a few emails a week, but the company churning out industrial quantities of advertising will be required to do prohibitively expensive computation. This is also how Bitcoin's consensus algorithm works.\n\n## How Anubis' proof of work scheme works\n\nA sha256 hash is a bunch of bytes like this:\n\n```text\n394d1cc82924c2368d4e34fa450c6b30d5d02f8ae4bb6310e2296593008ff89f\n```\n\nWe usually write it out in hex form, but that's literally what the bytes in ram look like. In a proof of work validation system, you take some base value (the \"challenge\") and a constantly incrementing number (the \"nonce\"), so the thing you end up hashing is this:\n\n```js\nconst hash = await sha256(`${challenge}${nonce}`);\n```\n\nIn order to pass a challenge, the `hash` has to have the right number of leading zeros (the \"difficulty\"). When a client requests to pass the challenge, they include the nonce they used. The server then only has to do one sha256 operation: the one that confirms that the challenge (generated from request metadata) and the nonce (provided by the client) match the difficulty number of leading zeroes.\n\nUltimately, this is a hack whose real purpose is to give a \"good enough\" placeholder solution so that more time can be spent on fingerprinting and identifying headless browsers (EG via how they do font rendering) so that the challenge proof of work page doesn't need to be presented to known legitimate users.\n"
},
{
"path": "docs/docs/developer/_category_.json",
"content": "{\n \"label\": \"Developer guides\",\n \"position\": 50,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Guides and suggestions to make Anubis development go smoothly for everyone.\"\n }\n}\n"
},
{
"path": "docs/docs/developer/ai-coding-policy.md",
"content": "# AI Coding Policy\n\nAt some level it would be nice to be able to have the following AI coding policy from an ideological standpoint:\n\n> Anubis does not accept code made primarily with the use of agentic AI tools such as Claude Code, Gemini CLI, GitHub Copilot, Zed, OpenCode, or any other similar tools. Please do not use them when contributing to this repo.\n\nHowever, I'd be in violation by doing this because I have knowingly committed minor bits of code to the Anubis repo that were generated by AI tools (mostly things for smoke tests).\n\nAs such, Anubis is taking more of a centrist approach with regards to AI coding tools: regardless of what tool you use to make contributions to Anubis, when you sign off your code, you are taking responsibility for what you commit. You are also expected to understand what you are changing, what the implications are, and all other relevant factors.\n\nIf you use AI coding tools for a majority of your committed work, you MUST disclose it with [the `Assisted-by` footer](https://xeiaso.net/notes/2025/assisted-by-footer/). The Anubis maintainers will be using tooling that looks for these footers and will prioritize scrutiny and level of attention appropriately.\n\nIn order to ensure compliance with this policy, language has been placed in `AGENTS.md` and `CLAUDE.md` to entice AI coding tools to add these footers.\n"
},
{
"path": "docs/docs/developer/building-anubis.md",
"content": "---\ntitle: Building Anubis without Docker\n---\n\n:::note\n\nThese instructions may work, but for right now they are informative for downstream packagers more than they are ready-made instructions for administrators wanting to run Anubis on their servers. Pre-made binary package support is being tracked in [#156](https://github.com/TecharoHQ/anubis/issues/156).\n\n:::\n\n## Entirely from source\n\nIf you are doing a build entirely from source, here's what you need to do:\n\n:::info\n\nIf you maintain a package for Anubis v1.15.x or older, you will need to update your package build. You may want to use one of the half-baked tarballs if your distro/environment of choice makes it difficult to use npm.\n\n:::\n\n### Tools needed\n\nIn order to build a production-ready binary of Anubis, you need the following packages in your environment:\n\n- [Go](https://go.dev) at least version 1.24 - the programming language that Anubis is written in\n- [esbuild](https://esbuild.github.io/) - the JavaScript bundler Anubis uses for its production JS assets\n- [Node.JS & NPM](https://nodejs.org/en) - manages some build dependencies\n- `gzip` - compresses production JS (part of coreutils)\n- `zstd` - compresses production JS\n- `brotli` - compresses production JS\n\nTo upgrade your version of Go without system package manager support, install `golang.org/dl/go1.24.2` (this can be done from any version of Go):\n\n```text\ngo install golang.org/dl/go1.24.2@latest\ngo1.24.2 download\n```\n\n### Install dependencies\n\n```text\nmake deps\n```\n\nThis will download Go and NPM dependencies.\n\n### Building static assets\n\n```text\nmake assets\n```\n\nThis will build all static assets (CSS, JavaScript) for distribution.\n\n### Building Anubis to the `./var` folder\n\n```text\nmake build\n```\n\nFrom this point it is up to you to make sure that `./var/anubis` and `./var/robots2policy` end up in\nthe right place. You may want to consult the `./run` folder for useful files such as a systemd unit\nand `anubis.env.default` file.\n\n## \"Pre-baked\" tarball\n\nThe `anubis-src-with-vendor` tarball has many pre-build steps already done, including:\n\n- Go module dependencies are present in `./vendor`\n- Static assets (JS, CSS, etc.) are already built in CI\n\nThis means you do not have to manage Go, NPM, or other ecosystem dependencies.\n\nWhen using this tarball, all you need to do is build `./cmd/anubis`:\n\n```text\nmake prebaked-build\n```\n\nAnubis will be built to `./var/anubis` and the robots2policy tool to `./var/robots2policy`.\n\n## Development dependencies\n\nOptionally, you can install the following dependencies for development:\n\n- [Staticcheck](https://staticcheck.dev/docs/getting-started/) (optional, not required due to [`go tool staticcheck`](https://www.alexedwards.net/blog/how-to-manage-tool-dependencies-in-go-1.24-plus), but required if you are using any version of Go older than 1.24)\n"
},
{
"path": "docs/docs/developer/local-dev.md",
"content": "---\ntitle: Local development\n---\n\nIf you use an editor with [Development containers](https://containers.dev) support, load this repo's [devcontainer configuration](https://github.com/TecharoHQ/anubis/tree/main/.devcontainer). Skip to [Running Anubis locally](#running-anubis-locally) if you are using the devcontainer.\n\nThis enables you to contribute from [GitHub Codespaces](https://github.com/features/codespaces) or other web-based editors.\n\n:::note\n\nTL;DR: `npm ci && npm run dev`\n\n:::\n\nAnubis requires the following tools to be installed to do local development:\n\n- [Go](https://go.dev) - the programming language that Anubis is written in\n- [esbuild](https://esbuild.github.io/) - the JavaScript bundler Anubis uses for its production JS assets\n- [Node.JS & NPM](https://nodejs.org/en) - manages some build dependencies\n- `gzip` - compresses production JS (part of coreutils)\n- `zstd` - compresses production JS\n- `brotli` - compresses production JS\n\nIf you have [Homebrew](https://brew.sh) installed, you can install all the dependencies with one command:\n\n```text\nbrew bundle\n```\n\nIf you don't, you may need to figure out equivalents to the packages in Homebrew.\n\n## Running Anubis locally\n\n```text\nnpm run dev\n```\n\nOr to do it manually:\n\n- Run `npm run assets` every time you change the CSS/JavaScript\n- `go run ./cmd/anubis` with any CLI flags you want\n\n## Building JS/CSS assets\n\n```text\nnpm run assets\n```\n\nIf you change the build process, make sure to update `build.sh` accordingly.\n\n## Production-ready builds\n\n```text\nnpm run container\n```\n\nThis builds a prod-ready container image with [ko](https://ko.build). If you want to change where the container image is pushed, you need to use environment variables:\n\n```text\nDOCKER_REPO=registry.host/org/repo DOCKER_METADATA_OUTPUT_TAGS=registry.host/org/repo:latest npm run container\n```\n\n## Building packages\n\nFor more information, see [Building native packages is complicated](https://xeiaso.net/blog/2025/anubis-packaging/) and [#156: Debian, RPM, and binary tarball packages](https://github.com/TecharoHQ/anubis/issues/156).\n\nInstall `yeet`:\n\n:::note\n\n`yeet` will soon be moved to a dedicated TecharoHQ repository. This is currently done in a hacky way in order to get this ready for user feedback.\n\n:::\n\n```text\ngo install within.website/x/cmd/yeet@v1.13.4\n```\n\nInstall the dependencies for Anubis:\n\n```text\nnpm ci\ngo mod download\n```\n\nBuild the packages into `./var`:\n\n```text\nyeet\n```\n"
},
{
"path": "docs/docs/developer/signed-commits.md",
"content": "---\ntitle: Signed commits\n---\n\nAnubis requires developers to sign their commits. This is done so that we can have a better chain of custody from contribution to owner. For more information about commit signing, [read here](https://www.freecodecamp.org/news/what-is-commit-signing-in-git/).\n\nWe do not require GPG. SSH signed commits are fine. For an overview on how to set up commit signing with your SSH key, [read here](https://dev.to/ccoveille/git-the-complete-guide-to-sign-your-commits-with-an-ssh-key-35bg).\n"
},
{
"path": "docs/docs/funding.md",
"content": "---\nsidebar_position: 998\ntitle: Supporting Anubis financially\n---\n\nAnubis is provided to the public for free in order to help advance the common good. In return, we ask (but not demand, these are words on the internet, not word of law) that you not remove the Anubis character from your deployment.\n\nIf you want to run an unbranded or white-label version of Anubis, please [contact Xe](https://xeiaso.net/contact) to arrange a contract. This is not meant to be \"contact us\" pricing, I am still evaluating the market for this solution and figuring out what makes sense.\n\nYou can donate to the project [on Patreon](https://patreon.com/cadey) or via [GitHub Sponsors](https://github.com/sponsors/Xe).\n"
},
{
"path": "docs/docs/index.mdx",
"content": "---\nsidebar_position: 1\ntitle: Anubis\n---\n\n<img\n width={256}\n src=\"/img/happy.webp\"\n alt=\"A smiling chibi dark-skinned anthro jackal with brown hair and tall ears looking victorious with a thumbs-up\"\n/>\n\n\n\n\n\n\n[](https://github.com/sponsors/Xe)\n\n## Sponsors\n\nAnubis is brought to you by sponsors and donors like:\n\n### Diamond Tier\n\n<a href=\"https://www.raptorcs.com/content/base/products.html\">\n <img\n src=\"/img/sponsors/raptor-computing-logo.webp\"\n alt=\"Raptor Computing Systems\"\n height=\"64\"\n />\n</a>\n<a href=\"https://databento.com/?utm_source=anubis&utm_medium=sponsor&utm_campaign=anubis\">\n <img src=\"/img/sponsors/databento-logo.webp\" alt=\"Databento\" height=\"64\" />\n</a>\n\n### Gold Tier\n\n<a href=\"https://www.unipromos.com/?utm_campaign=github&utm_medium=referral&utm_content=anubis\">\n <img src=\"/img/sponsors/unipromos.webp\" alt=\"Uvensys\" height=\"64\" />\n</a>\n<a href=\"https://uvensys.de/?utm_campaign=github&utm_medium=referral&utm_content=anubis\">\n <img src=\"/img/sponsors/uvensys.webp\" alt=\"Uvensys\" height=\"64\" />\n</a>\n<a href=\"https://distrust.co?utm_campaign=github&utm_medium=referral&utm_content=anubis\">\n <img src=\"/img/sponsors/distrust-logo.webp\" alt=\"Distrust\" height=\"64\" />\n</a>\n<a href=\"https://about.gitea.com?utm_campaign=github&utm_medium=referral&utm_content=anubis\">\n <img src=\"/img/sponsors/gitea-logo.webp\" alt=\"Gitea\" height=\"64\" />\n</a>\n<a href=\"https://prolocation.net?utm_campaign=github&utm_medium=referral&utm_content=anubis\">\n <img src=\"/img/sponsors/prolocation-logo.svg\" alt=\"Prolocation\" height=\"64\" />\n</a>\n<a href=\"https://terminaltrove.com/?utm_campaign=github&utm_medium=referral&utm_content=anubis&utm_source=abgh\">\n <img\n src=\"/img/sponsors/terminal-trove.webp\"\n alt=\"Terminal Trove\"\n height=\"64\"\n />\n</a>\n<a href=\"https://canine.tools?utm_campaign=github&utm_medium=referral&utm_content=anubis\">\n <img\n src=\"/img/sponsors/caninetools-logo.webp\"\n alt=\"canine.tools\"\n height=\"64\"\n />\n</a>\n<a href=\"https://weblate.org/\">\n <img src=\"/img/sponsors/weblate-logo.webp\" alt=\"Weblate\" height=\"64\" />\n</a>\n<a href=\"https://uberspace.de/\">\n <img src=\"/img/sponsors/uberspace-logo.webp\" alt=\"Uberspace\" height=\"64\" />\n</a>\n<a href=\"https://wildbase.xyz/\">\n <img src=\"/img/sponsors/wildbase-logo.webp\" alt=\"Wildbase\" height=\"64\" />\n</a>\n<a href=\"https://emma.pet\">\n <img\n src=\"/img/sponsors/nepeat-logo.webp\"\n alt=\"Cat eyes over the word Emma in a serif font\"\n height=\"64\"\n />\n</a>\n<a href=\"https://fabulous.systems/\">\n <img\n src=\"/img/sponsors/fabulous-systems.webp\"\n alt=\"Cat eyes over the word Emma in a serif font\"\n height=\"64\"\n />\n</a>\n\n## Overview\n\nAnubis is a Web AI Firewall Utility that [weighs the soul of your connection](https://en.wikipedia.org/wiki/Weighing_of_souls) using one or more challenges in order to protect upstream resources from scraper bots.\n\nThis program is designed to help protect the small internet from the endless storm of requests that flood in from AI companies. Anubis is as lightweight as possible to ensure that everyone can afford to protect the communities closest to them.\n\nAnubis is a bit of a nuclear response. This will result in your website being blocked from smaller scrapers and may inhibit \"good bots\" like the Internet Archive. You can configure [bot policy definitions](https://anubis.techaro.lol/docs/admin/policies) to explicitly allowlist them and we are working on a curated set of \"known good\" bots to allow for a compromise between discoverability and uptime.\n\nIn most cases, you should not need this and can probably get by using Cloudflare to protect a given origin. However, for circumstances where you can't or won't use Cloudflare, Anubis is there for you.\n\n## Support\n\nIf you run into any issues running Anubis, please [open an issue](https://github.com/TecharoHQ/anubis/issues/new?template=Blank+issue) and include all the information I would need to diagnose your issue.\n\nFor live chat, please join the [Patreon](https://patreon.com/cadey) or join [GitHub Sponsors](https://github.com/sponsors/Xe) and ask in the Patron discord in the channel `#anubis`.\n\n## Star History\n\n<a href=\"https://www.star-history.com/#TecharoHQ/anubis&Date\">\n <picture>\n <source\n media=\"(prefers-color-scheme: dark)\"\n srcSet=\"https://api.star-history.com/svg?repos=TecharoHQ/anubis&type=Date&theme=dark\"\n />\n <source\n media=\"(prefers-color-scheme: light)\"\n srcSet=\"https://api.star-history.com/svg?repos=TecharoHQ/anubis&type=Date\"\n />\n <img\n alt=\"Star History Chart\"\n src=\"https://api.star-history.com/svg?repos=TecharoHQ/anubis&type=Date\"\n />\n </picture>\n</a>\n\n## Packaging Status\n\n[](https://repology.org/project/anubis-anti-crawler/versions)\n\n## Contributors\n\n<a href=\"https://github.com/TecharoHQ/anubis/graphs/contributors\">\n <img src=\"https://contrib.rocks/image?repo=TecharoHQ/anubis\" />\n</a>\n\nMade with [contrib.rocks](https://contrib.rocks).\n"
},
{
"path": "docs/docs/user/_category_.json",
"content": "{\n \"label\": \"User guides\",\n \"position\": 60,\n \"link\": {\n \"type\": \"generated-index\",\n \"description\": \"Information for users on sites that use Anubis.\"\n }\n}\n"
},
{
"path": "docs/docs/user/frequently-asked-questions.mdx",
"content": "# Frequently Asked Questions\n\n## Why can't you just put details about the proof of work challenge into the challenge page so I don't need to run JavaScript?\n\nA common question is something along the lines of \"why can't you give me a shell script to run the challenge on my laptop so that I don't have to enable JavaScript\". Malware has been known to show an interstitial that [asks the user to paste something into their run box on Windows](https://www.malwarebytes.com/blog/news/2025/03/fake-captcha-websites-hijack-your-clipboard-to-install-information-stealers), which will then make that machine a zombie in a botnet.\n\nIt would be in very bad taste to associate a security product such as Anubis with behavior similar to what malware uses. This would destroy user trust in the product and potentially result in reputational damage for the contributors. When at all possible, we want to avoid this happening.\n\nTechnically inclined users are easily able to understand how the proof of work check works by either reading the JavaScript on the page or [reading the source code of the JavaScript program](https://github.com/TecharoHQ/anubis/tree/main/web/js). Please note that the format of the challenges and the algorithms used to solve them are liable to change without notice and are not considered part of the public API of Anubis. When such a change occurs, this will break your workarounds.\n\nIf [sufficient funding is raised](https://github.com/TecharoHQ/anubis/discussions/278), a browser extension that packages the proof of work checks and looks for Anubis challenge pages to solve them will be created.\n\n## Why does Anubis use [Web Workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers) to do its proof of work challenge?\n\nAnubis uses [Web Workers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API/Using_web_workers) to do its proof of work challenge for two main reasons:\n\n1. The proof of work operation is a lot of serially blocking calls. If you do serially blocking calls in JavaScript, some browsers will hang and not respond to user input. This is bad user experience. Using a Web Worker allows the browser to do this computation in the background so your browser will not hang.\n2. Web Workers allow you to do multithreaded execution of JavaScript code. This lets Anubis run its checks in parallel across all your system cores so that the challenge can complete as fast as possible. In the last decade, most CPU advancements have come from making cores and code extremely parallel. Using Web Workers lets Anubis take advantage of your hardware as much as possible so that the challenge finishes as fast as possible.\n\nIf you use a browser extension such as [JShelter](https://jshelter.org/), you will need to [modify your JShelter configuration](./known-broken-extensions.md#jshelter) to allow Anubis' proof of work computation to complete.\n\n## Does Anubis mine Bitcoin?\n\nNo. Anubis does not mine Bitcoin or any other cryptocurrency.\n"
},
{
"path": "docs/docs/user/known-broken-extensions.md",
"content": "---\ntitle: List of known browser extensions that can break Anubis\n---\n\nThis page contains a list of all of the browser extensions that are known to break Anubis' functionality and their associated GitHub issues, along with instructions on how to work around the issue.\n\n## [JShelter](https://jshelter.org/)\n\n| Extension | JShelter |\n| :----------- | :------------------------------------------------------------------------------------------------------------------------------------------------- |\n| Website | [jshelter.org](https://jshelter.org/) |\n| GitHub issue | https://github.com/TecharoHQ/anubis/issues/25 |\n| Be aware of | [What are Web Workers, and what are the threats that I face?](https://jshelter.org/faq/#what-are-web-workers-and-what-are-the-threats-that-i-face) |\n\n### Workaround steps (recommended):\n\n1. Click on the JShelter badge icon (typically in the toolbar next to your navigation bar; if you cannot locate the icon, see [this question](https://jshelter.org/faq/#can-i-see-a-jshelter-badge-icon-next-to-my-navigation-bar-i-want-to-interact-with-the-extension-easily-and-avoid-going-through-settings)).\n2. Expand JavaScript Shield settings by clicking on the `Modify` button.\n3. Click on the `Detail tweaks of JS shield for this site` button.\n4. Click and drag the `WebWorker` slider to the left until `Remove` is replaced by the `Unprotected`.\n5. Refresh the page, for example, by clicking on the `Refresh page` button at the top of the JShelter pop up window.\n6. You might want to restore the Worker settings once you go through the challenge.\n\n### Workaround steps (alternative if you do not want to dig in JShelter's pop up):\n\n1. Click on the JShelter badge icon (typically in the toolbar next to your navigation bar; if you cannot locate the icon, see [this question](https://jshelter.org/faq/#can-i-see-a-jshelter-badge-icon-next-to-my-navigation-bar-i-want-to-interact-with-the-extension-easily-and-avoid-going-through-settings)).\n2. Expand JavaScript Shield settings by clicking on the `Modify` button.\n3. Choose \"Turn JavaScript Shield off\"\n4. Refresh the page, for example, by clicking on the `Refresh page` button at the top of the JShelter pop up window.\n\n:::note\n\nTaking these actions will remove all protections of JavaScript Shield for all pages at the visited web site. You might want review and amend your JavaScript shield settings once you go through the challenge based on your operational security model.\n\n:::\n\n### Workaround steps (alternative if you do not like JShelter's pop up):\n\n1. Open JShelter extension settings\n2. Click on JS Shield details\n3. Enter in the domain for a website protected by Anubis\n4. Choose \"Turn JavaScript Shield off\"\n5. Hit \"Add to list\"\n\n:::note\n\nTaking these actions will remove all protections of JavaScript Shield for all pages at the visited web site. You might want review and amend your JavaScript shield settings once you go through the challenge based on your operational security model.\n\n:::\n"
},
{
"path": "docs/docs/user/known-instances.md",
"content": "---\ntitle: List of known websites using Anubis\n---\n\nThis page contains a non-exhaustive list with all websites using Anubis.\n\n- https://azurlane.koumakan.jp/\n- https://bugs.winehq.org/\n- https://bugzilla.proxmox.com\n- https://canine.tools/\n- https://clew.se/\n- https://code.hackerspace.pl/\n- https://codeberg.org/\n- https://dev.haiku-os.org\n- https://dev.sanctum.geek.nz/\n- https://ebird.org/\n- https://extensions.typo3.org/\n- https://fabulous.systems/\n- https://git.aya.so/\n- https://git.devuan.org/\n- https://git.enlightenment.org/\n- https://gitea.com/\n- https://gitlab.freedesktop.org/\n- https://gitlab.gnome.org/\n- https://gitlab.postmarketos.org/\n- https://hosted.weblate.org/\n- https://hydra.nixos.org/\n- https://lab.civicrm.org/\n- https://marginalia-search.com/\n- https://mozillazine.org/\n- https://openwrt.org/\n- https://pluralpedia.org/\n- https://reddit.nerdvpn.de/\n- https://repositorio.ufrn.br/home/\n- https://rpmfusion.org/\n- https://scioly.org/\n- https://source.puri.sm/\n- https://squirreljme.cc/\n- https://superlove.sayitditto.net/\n- https://svnweb.freebsd.org/\n- https://tumfatig.net/\n- https://wiki.archlinux.org/\n- https://wiki.freepascal.org/\n- https://wiki.koha-community.org/\n- https://www.cfaarchive.org/\n- https://www.indiemag.fr/\n- https://xeiaso.net/\n- <details>\n <summary>archlinux32.org</summary>\n - https://www.archlinux32.org/packages/\n - https://bbs.archlinux32.org/\n - https://bugs.archlinux32.org/\n </details>\n- <details>\n <summary>Dolphin Emulator</summary>\n - https://forums.dolphin-emu.org/\n - https://wiki.dolphin-emu.org/\n </details>\n- <details>\n <summary>Duke University</summary>\n - https://repository.duke.edu/\n - https://archives.lib.duke.edu/\n - https://find.library.duke.edu/\n - https://nicholas.duke.edu/\n </details>\n- <details>\n <summary>FFmpeg</summary>\n - https://git.ffmpeg.org/\n - https://trac.ffmpeg.org/\n </details>\n- <details>\n <summary>Forschungszentrum Jülich</summary>\n - https://juser.fz-juelich.de/\n </details>\n- <details>\n <summary>FreeCAD</summary>\n - https://forum.freecad.org/\n - https://wiki.freecad.org/\n </details>\n- <details>\n <summary>HackLab.TO</summary>\n - https://hacklab.to/\n - https://knowledge.hacklab.to/\n </details>\n- <details>\n <summary>hebis (Alliance of Hessian Libraries)</summary>\n - https://ubmr.hds.hebis.de/\n - https://tufind.hds.hebis.de/\n - https://karla.hds.hebis.de/\n - and many more (see https://www.hebis.de/dienste/hebis-discovery-system/)\n </details>\n- <details>\n <summary>ReactOS</summary>\n - https://reactos.org/forum\n - https://reactos.org/wiki\n - https://git.reactos.org\n </details>\n- <details>\n <summary>ScummVM</summary>\n - https://bugs.scummvm.org/\n - https://forums.scummvm.org/\n - https://wiki.scummvm.org/\n </details>\n- <details>\n <summary>Slackware</summary>\n - https://git.slackware.nl/\n - https://git.liveslak.org/\n </details>\n- <details>\n <summary>Sourceware</summary>\n - https://sourceware.org/cgit\n - https://sourceware.org/glibc/wiki\n - https://builder.sourceware.org/testruns/\n - https://patchwork.sourceware.org/\n - https://gcc.gnu.org/bugzilla/\n - https://gcc.gnu.org/cgit\n </details>\n- <details>\n <summary>The Linux Foundation</summary>\n - https://git.kernel.org/\n - https://lore.kernel.org/\n </details>\n- <details>\n <summary>Valve Corporation</summary>\n - https://developer.valvesoftware.com/wiki/Main_Page\n - https://wiki.teamfortress.com/wiki/Main_Page\n </details>\n"
},
{
"path": "docs/docs/user/why-see-challenge.md",
"content": "---\ntitle: Why is Anubis showing up on a website?\n---\n\nYou are seeing Anubis because the administrator of that website has set up [Anubis](https://github.com/TecharoHQ/anubis) to protect the server against the scourge of [AI companies aggressively scraping websites](https://thelibre.news/foss-infrastructure-is-under-attack-by-ai-companies/). This can and does cause downtime for the websites, which makes their resources inaccessible for everyone.\n\nAnubis is a compromise. Anubis uses a [proof-of-work](/docs/design/why-proof-of-work) scheme in the vein of [Hashcash](https://en.wikipedia.org/wiki/Hashcash), a proposed proof-of-work scheme for reducing email spam. The idea is that at individual scales the additional load is ignorable, but at mass scraper levels it adds up and makes scraping much more expensive.\n\nUltimately, this is a hack whose real purpose is to give a \"good enough\" placeholder solution so that more time can be spent on fingerprinting and identifying headless browsers (EG: via how they do font rendering) so that the challenge proof of work page doesn't need to be presented to users that are much more likely to be legitimate.\n"
},
{
"path": "docs/docusaurus.config.ts",
"content": "import { themes as prismThemes } from \"prism-react-renderer\";\nimport type { Config } from \"@docusaurus/types\";\nimport type * as Preset from \"@docusaurus/preset-classic\";\n\n// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)\n\nconst config: Config = {\n title: \"Anubis\",\n tagline: \"Weigh the soul of incoming HTTP requests to protect your website!\",\n favicon: \"img/favicon.ico\",\n\n // Set the production url of your site here\n url: \"https://anubis.techaro.lol\",\n // Set the /<baseUrl>/ pathname under which your site is served\n // For GitHub pages deployment, it is often '/<projectName>/'\n baseUrl: \"/\",\n\n // GitHub pages deployment config.\n // If you aren't using GitHub pages, you don't need these.\n organizationName: \"TecharoHQ\", // Usually your GitHub org/user name.\n projectName: \"anubis\", // Usually your repo name.\n\n onBrokenLinks: \"throw\",\n onBrokenMarkdownLinks: \"warn\",\n\n // Even if you don't use internationalization, you can use this field to set\n // useful metadata like html lang. For example, if your site is Chinese, you\n // may want to replace \"en\" with \"zh-Hans\".\n i18n: {\n defaultLocale: \"en\",\n locales: [\"en\"],\n },\n\n markdown: {\n mermaid: true,\n },\n themes: [\"@docusaurus/theme-mermaid\"],\n\n presets: [\n [\n \"classic\",\n {\n blog: {\n showReadingTime: true,\n feedOptions: {\n type: [\"rss\", \"atom\", \"json\"],\n xslt: true,\n },\n editUrl: \"https://github.com/TecharoHQ/anubis/tree/main/docs/\",\n onInlineTags: \"warn\",\n onInlineAuthors: \"warn\",\n onUntruncatedBlogPosts: \"throw\",\n },\n docs: {\n sidebarPath: \"./sidebars.ts\",\n editUrl: \"https://github.com/TecharoHQ/anubis/tree/main/docs/\",\n },\n theme: {\n customCss: \"./src/css/custom.css\",\n },\n } satisfies Preset.Options,\n ],\n ],\n\n themeConfig: {\n colorMode: {\n respectPrefersColorScheme: true,\n },\n // Replace with your project's social card\n image: \"img/social-card.jpg\",\n navbar: {\n title: \"Anubis\",\n logo: {\n alt: \"A happy jackal woman with brown hair and red eyes\",\n src: \"img/favicon.webp\",\n },\n items: [\n { to: \"/blog\", label: \"Blog\", position: \"left\" },\n {\n type: \"docSidebar\",\n sidebarId: \"tutorialSidebar\",\n position: \"left\",\n label: \"Docs\",\n },\n {\n to: \"/docs/admin/botstopper\",\n label: \"Unbranded Version\",\n position: \"left\",\n },\n {\n href: \"https://github.com/TecharoHQ/anubis\",\n label: \"GitHub\",\n position: \"right\",\n },\n {\n href: \"https://github.com/sponsors/Xe\",\n label: \"Sponsor the Project\",\n position: \"right\",\n },\n ],\n },\n footer: {\n style: \"dark\",\n links: [\n {\n title: \"Docs\",\n items: [\n {\n label: \"Intro\",\n to: \"/docs/\",\n },\n {\n label: \"Installation\",\n to: \"/docs/admin/installation\",\n },\n ],\n },\n {\n title: \"Community\",\n items: [\n {\n label: \"GitHub Discussions\",\n href: \"https://github.com/TecharoHQ/anubis/discussions\",\n },\n {\n label: \"Bluesky\",\n href: \"https://bsky.app/profile/techaro.lol\",\n },\n ],\n },\n {\n title: \"More\",\n items: [\n {\n label: \"Blog\",\n to: \"/blog\",\n },\n {\n label: \"GitHub\",\n href: \"https://github.com/TecharoHQ/anubis\",\n },\n {\n label: \"Status\",\n href: \"https://techarohq.github.io/status/\",\n },\n ],\n },\n ],\n copyright: `Copyright © ${new Date().getFullYear()} Techaro. Made with ❤️ in 🇨🇦.`,\n },\n prism: {\n theme: prismThemes.github,\n darkTheme: prismThemes.dracula,\n magicComments: [\n {\n className: \"code-block-diff-add-line\",\n line: \"diff-add\",\n },\n {\n className: \"code-block-diff-remove-line\",\n line: \"diff-remove\",\n },\n ],\n },\n } satisfies Preset.ThemeConfig,\n};\n\nexport default config;\n"
},
{
"path": "docs/fly.toml",
"content": "app = 'anubis-docs'\nprimary_region = 'yyz'\n\n[build]\n image = \"ghcr.io/techarohq/anubis/docs:main\"\n\n[http_service]\n internal_port = 80\n force_https = true\n auto_stop_machines = true\n auto_start_machines = true\n min_machines_running = 0\n processes = ['app']\n\n[[vm]]\n cpu_kind = 'shared'\n cpus = 1\n memory_mb = 256\n\n"
},
{
"path": "docs/manifest/1password.yaml",
"content": "apiVersion: onepassword.com/v1\nkind: OnePasswordItem\nmetadata:\n name: anubis-docs-thoth\nspec:\n itemPath: \"vaults/lc5zo4zjz3if3mkeuhufjmgmui/items/pwguumqcmtxvqbeb7y4gj7l36i\"\n"
},
{
"path": "docs/manifest/cfg/anubis/botPolicies.yaml",
"content": "## Anubis has the ability to let you import snippets of configuration into the main\n## configuration file. This allows you to break up your config into smaller parts\n## that get logically assembled into one big file.\n##\n## Of note, a bot rule can either have inline bot configuration or import a\n## bot config snippet. You cannot do both in a single bot rule.\n##\n## Import paths can either be prefixed with (data) to import from the common/shared\n## rules in the data folder in the Anubis source tree or will point to absolute/relative\n## paths in your filesystem. If you don't have access to the Anubis source tree, check\n## /usr/share/docs/anubis/data or in the tarball you extracted Anubis from.\n\nbots:\n - import: (data)/crawlers/commoncrawl.yaml\n # Pathological bots to deny\n - # This correlates to data/bots/deny-pathological.yaml in the source tree\n # https://github.com/TecharoHQ/anubis/blob/main/data/bots/deny-pathological.yaml\n import: (data)/bots/_deny-pathological.yaml\n - import: (data)/bots/aggressive-brazilian-scrapers.yaml\n\n # Aggressively block AI/LLM related bots/agents by default\n - import: (data)/meta/ai-block-aggressive.yaml\n\n # Consider replacing the aggressive AI policy with more selective policies:\n # - import: (data)/meta/ai-block-moderate.yaml\n # - import: (data)/meta/ai-block-permissive.yaml\n\n # Search engine crawlers to allow, defaults to:\n # - Google (so they don't try to bypass Anubis)\n # - Apple\n # - Bing\n # - DuckDuckGo\n # - Qwant\n # - The Internet Archive\n # - Kagi\n # - Marginalia\n # - Mojeek\n - import: (data)/crawlers/_allow-good.yaml\n # Challenge Firefox AI previews\n - import: (data)/clients/x-firefox-ai.yaml\n\n # Allow common \"keeping the internet working\" routes (well-known, favicon, robots.txt)\n - import: (data)/common/keep-internet-working.yaml\n\n # # Punish any bot with \"bot\" in the user-agent string\n # # This is known to have a high false-positive rate, use at your own risk\n # - name: generic-bot-catchall\n # user_agent_regex: (?i:bot|crawler)\n # action: CHALLENGE\n # challenge:\n # difficulty: 16 # impossible\n # algorithm: slow # intentionally waste CPU cycles and time\n\n - name: rss-feed-blog\n action: ALLOW\n expression:\n any:\n - path.startsWith(\"/blog/atom.\")\n - path.startsWith(\"/blog/rss.\")\n\n # Generic catchall rule\n - name: base-weight\n expression: \"true\"\n action: WEIGH\n weight:\n adjust: 10\n\n - name: http2-client-protocol\n expression:\n all:\n - '\"X-Http-Protocol\" in headers'\n - headers[\"X-Http-Protocol\"] == \"HTTP/2.0\"\n action: WEIGH\n weight:\n adjust: -5\n\n# The weight thresholds for when to trigger individual challenges. Any\n# CHALLENGE will take precedence over this.\n#\n# A threshold has four configuration options:\n#\n# - name: the name that is reported down the stack and used for metrics\n# - expression: A CEL expression with the request weight in the variable\n# weight\n# - action: the Anubis action to apply, similar to in a bot policy\n# - challenge: which challenge to send to the user, similar to in a bot policy\n#\n# See https://anubis.techaro.lol/docs/admin/configuration/thresholds for more\n# information.\nthresholds:\n # By default Anubis ships with the following thresholds:\n - name: minimal-suspicion # This client is likely fine, its soul is lighter than a feather\n expression: weight <= 0 # a feather weighs zero units\n action: ALLOW # Allow the traffic through\n # For clients that had some weight reduced through custom rules, give them a\n # lightweight challenge.\n - name: mild-suspicion\n expression:\n all:\n - weight > 0\n - weight < 10\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/metarefresh\n algorithm: metarefresh\n difficulty: 1\n # For clients that are browser-like but have either gained points from custom rules or\n # report as a standard browser.\n - name: moderate-suspicion\n expression:\n all:\n - weight >= 10\n - weight < 20\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/preact\n #\n # This challenge proves the client can run a webapp written with Preact.\n # The preact webapp simply loads, calculates the SHA-256 checksum of the\n # challenge data, and forwards that to the client.\n algorithm: preact\n difficulty: 1\n - name: mild-proof-of-work\n expression:\n all:\n - weight >= 20\n - weight < 30\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 2 # two leading zeros, very fast for most clients\n # For clients that are browser like and have gained many points from custom rules\n - name: extreme-suspicion\n expression: weight >= 30\n action: CHALLENGE\n challenge:\n # https://anubis.techaro.lol/docs/admin/configuration/challenges/proof-of-work\n algorithm: fast\n difficulty: 4\n\ndnsbl: false\n\nimpressum:\n footer: |\n This website is hosted by Techaro. If you have any complaints or notes about the service, please contact <a href=\"mailto:support@techaro.lol\">support@techaro.lol</a> and we will assist you as soon as possible.\n\n page:\n title: Privacy Policy\n body: |\n <p>Last updated: June 2025</p>\n\n <h2>Information that is gathered from visitors</h2>\n\n <p>In common with other websites, log files are stored on the web server saving details such as the visitor's IP address, browser type, referring page and time of visit.</p>\n\n <p>Cookies may be used to remember visitor preferences when interacting with the website.</p>\n\n <p>Where registration is required, the visitor's email and a username will be stored on the server.</p>\n\n <h2>How the Information is used</h2>\n\n <p>The information is used to enhance the visitor's experience when using the website to display personalised content and possibly advertising.</p>\n\n <p>E-mail addresses will not be sold, rented or leased to 3rd parties.</p>\n\n <p>E-mail may be sent to inform you of news of our services or offers by us or our affiliates.</p>\n\n <h2>Visitor Options</h2>\n\n <p>If you have subscribed to one of our services, you may unsubscribe by following the instructions which are included in e-mail that you receive.</p>\n\n <p>You may be able to block cookies via your browser settings but this may prevent you from access to certain features of the website.</p>\n\n <h2>Cookies</h2>\n\n <p>Cookies are small digital signature files that are stored by your web browser that allow your preferences to be recorded when visiting the website. Also they may be used to track your return visits to the website.</p>\n\n <p>3rd party advertising companies may also use cookies for tracking purposes.</p>\n\n <h2>Techaro Anubis</h2>\n\n <p>This website uses a service called <a href=\"https://anubis.techaro.lol\">Anubis</a> to filter malicious traffic. Anubis requires the use of browser cookies to ensure that web clients are running conformant software. Anubis also may report the following data to Techaro to improve service quality:</p>\n\n <ul>\n <li>IP address (for purposes of matching against geo-location and BGP autonomous systems numbers), which is stored in-memory and not persisted to disk.</li>\n <li>Unique browser fingerprints (such as HTTP request fingerprints and encryption system fingerprints), which may be stored on Techaro's side for a period of up to one month.</li>\n <li>HTTP request metadata that may include things such as the User-Agent header and other identifiers.</li>\n </ul>\n\n <p>This data is processed and stored for the legitimate interest of combatting abusive web clients. This data is encrypted at rest as much as possible and is only decrypted in memory for the purposes of fulfilling requests.</p>\n\n# By default, send HTTP 200 back to clients that either get issued a challenge\n# or a denial. This seems weird, but this is load-bearing due to the fact that\n# the most aggressive scraper bots seem to really, really, want an HTTP 200 and\n# will stop sending requests once they get it.\nstatus_codes:\n CHALLENGE: 200\n DENY: 200\n\nstore:\n backend: bbolt\n parameters:\n path: /xe/data/anubis/data.bdb\n"
},
{
"path": "docs/manifest/cfg/nginx/mime.types",
"content": "\ntypes {\n text/html html htm shtml;\n text/css css;\n text/xml xml;\n image/gif gif;\n image/jpeg jpeg jpg;\n application/javascript js;\n application/atom+xml atom;\n application/rss+xml rss;\n\n text/mathml mml;\n text/plain txt;\n text/vnd.sun.j2me.app-descriptor jad;\n text/vnd.wap.wml wml;\n text/x-component htc;\n\n image/avif avif;\n image/png png;\n image/svg+xml svg svgz;\n image/tiff tif tiff;\n image/vnd.wap.wbmp wbmp;\n image/webp webp;\n image/x-icon ico;\n image/x-jng jng;\n image/x-ms-bmp bmp;\n\n font/woff woff;\n font/woff2 woff2;\n\n application/java-archive jar war ear;\n application/json json;\n application/mac-binhex40 hqx;\n application/msword doc;\n application/pdf pdf;\n application/postscript ps eps ai;\n application/rtf rtf;\n application/vnd.apple.mpegurl m3u8;\n application/vnd.google-earth.kml+xml kml;\n application/vnd.google-earth.kmz kmz;\n application/vnd.ms-excel xls;\n application/vnd.ms-fontobject eot;\n application/vnd.ms-powerpoint ppt;\n application/vnd.oasis.opendocument.graphics odg;\n application/vnd.oasis.opendocument.presentation odp;\n application/vnd.oasis.opendocument.spreadsheet ods;\n application/vnd.oasis.opendocument.text odt;\n application/vnd.openxmlformats-officedocument.presentationml.presentation\n pptx;\n application/vnd.openxmlformats-officedocument.spreadsheetml.sheet\n xlsx;\n application/vnd.openxmlformats-officedocument.wordprocessingml.document\n docx;\n application/vnd.wap.wmlc wmlc;\n application/wasm wasm;\n application/x-7z-compressed 7z;\n application/x-cocoa cco;\n application/x-java-archive-diff jardiff;\n application/x-java-jnlp-file jnlp;\n application/x-makeself run;\n application/x-perl pl pm;\n application/x-pilot prc pdb;\n application/x-rar-compressed rar;\n application/x-redhat-package-manager rpm;\n application/x-sea sea;\n application/x-shockwave-flash swf;\n application/x-stuffit sit;\n application/x-tcl tcl tk;\n application/x-x509-ca-cert der pem crt;\n application/x-xpinstall xpi;\n application/xhtml+xml xhtml;\n application/xspf+xml xspf;\n application/zip zip;\n\n application/octet-stream bin exe dll;\n application/octet-stream deb;\n application/octet-stream dmg;\n application/octet-stream iso img;\n application/octet-stream msi msp msm;\n\n audio/midi mid midi kar;\n audio/mpeg mp3;\n audio/ogg ogg;\n audio/x-m4a m4a;\n audio/x-realaudio ra;\n\n video/3gpp 3gpp 3gp;\n video/mp2t ts;\n video/mp4 mp4;\n video/mpeg mpeg mpg;\n video/quicktime mov;\n video/webm webm;\n video/x-flv flv;\n video/x-m4v m4v;\n video/x-mng mng;\n video/x-ms-asf asx asf;\n video/x-ms-wmv wmv;\n video/x-msvideo avi;\n}\n"
},
{
"path": "docs/manifest/cfg/nginx/nginx.conf",
"content": "user nginx;\nworker_processes 2;\nerror_log /dev/stdout warn;\npid /nginx.pid;\n\nevents {\n worker_connections 1024;\n}\n\nhttp {\n include mime.types;\n default_type application/octet-stream;\n access_log /dev/stdout;\n\n sendfile on;\n keepalive_timeout 65;\n\n server {\n listen 80 default_server;\n server_name _;\n\n error_page 404 /404.html;\n\n root /www;\n index index.html;\n\n location / {\n try_files $uri $uri/ =404;\n }\n }\n}"
},
{
"path": "docs/manifest/deployment.yaml",
"content": "apiVersion: apps/v1\nkind: Deployment\nmetadata:\n name: anubis-docs\nspec:\n selector:\n matchLabels:\n app: anubis-docs\n template:\n metadata:\n labels:\n app: anubis-docs\n spec:\n volumes:\n - name: anubis\n configMap:\n name: anubis-cfg\n - name: nginx\n configMap:\n name: nginx-cfg\n - name: temporary-data\n emptyDir: {}\n containers:\n - name: anubis-docs\n image: ghcr.io/techarohq/anubis/docs:main\n imagePullPolicy: Always\n resources:\n limits:\n memory: \"128Mi\"\n cpu: \"500m\"\n requests:\n cpu: 250m\n memory: 128Mi\n volumeMounts:\n - name: nginx\n mountPath: /conf\n ports:\n - containerPort: 80\n readinessProbe:\n httpGet:\n path: /\n port: 80\n initialDelaySeconds: 1\n periodSeconds: 10\n livenessProbe:\n httpGet:\n path: /\n port: 80\n initialDelaySeconds: 10\n periodSeconds: 20\n - name: anubis\n image: ghcr.io/techarohq/anubis:main\n imagePullPolicy: Always\n env:\n - name: \"BIND\"\n value: \":8081\"\n - name: \"DIFFICULTY\"\n value: \"4\"\n - name: \"METRICS_BIND\"\n value: \":9090\"\n - name: \"OG_PASSTHROUGH\"\n value: \"true\"\n - name: \"POLICY_FNAME\"\n value: \"/xe/cfg/anubis/botPolicies.yaml\"\n - name: \"SERVE_ROBOTS_TXT\"\n value: \"false\"\n - name: \"TARGET\"\n value: \"http://localhost:80\"\n # - name: \"SLOG_LEVEL\"\n # value: \"debug\"\n volumeMounts:\n - name: anubis\n mountPath: /xe/cfg/anubis\n - name: temporary-data\n mountPath: /xe/data/anubis\n resources:\n limits:\n cpu: 500m\n memory: 128Mi\n requests:\n cpu: 250m\n memory: 128Mi\n securityContext:\n runAsUser: 1000\n runAsGroup: 1000\n runAsNonRoot: true\n allowPrivilegeEscalation: false\n capabilities:\n drop:\n - ALL\n seccompProfile:\n type: RuntimeDefault\n envFrom:\n - secretRef:\n name: anubis-docs-thoth\n readinessProbe:\n httpGet:\n path: /healthz\n port: 9090\n initialDelaySeconds: 1\n periodSeconds: 10\n livenessProbe:\n httpGet:\n path: /healthz\n port: 9090\n initialDelaySeconds: 10\n periodSeconds: 20\n"
},
{
"path": "docs/manifest/ingress.yaml",
"content": "apiVersion: networking.k8s.io/v1\nkind: Ingress\nmetadata:\n name: anubis-docs\n annotations:\n cert-manager.io/cluster-issuer: \"letsencrypt-prod\"\n nginx.ingress.kubernetes.io/limit-rps: \"10\"\nspec:\n ingressClassName: nginx\n tls:\n - hosts:\n - anubis.techaro.lol\n secretName: anubis-techaro-lol-public-tls\n rules:\n - host: anubis.techaro.lol\n http:\n paths:\n - pathType: Prefix\n path: \"/\"\n backend:\n service:\n name: anubis-docs\n port:\n name: anubis\n"
},
{
"path": "docs/manifest/kustomization.yaml",
"content": "resources:\n - 1password.yaml\n - deployment.yaml\n - ingress.yaml\n - onionservice.yaml\n - poddisruptionbudget.yaml\n - service.yaml\n\nconfigMapGenerator:\n - name: anubis-cfg\n behavior: create\n files:\n - ./cfg/anubis/botPolicies.yaml\n - name: nginx-cfg\n behavior: create\n files:\n - ./cfg/nginx/mime.types\n - ./cfg/nginx/nginx.conf\n"
},
{
"path": "docs/manifest/onionservice.yaml",
"content": "apiVersion: tor.k8s.torproject.org/v1alpha2\nkind: OnionService\nmetadata:\n name: anubis-docs\nspec:\n version: 3\n rules:\n - port:\n number: 80\n backend:\n service:\n name: anubis-docs\n port:\n number: 80\n"
},
{
"path": "docs/manifest/poddisruptionbudget.yaml",
"content": "apiVersion: policy/v1\nkind: PodDisruptionBudget\nmetadata:\n name: anubis-docs\nspec:\n minAvailable: 1\n selector:\n matchLabels:\n app: anubis-docs\n"
},
{
"path": "docs/manifest/service.yaml",
"content": "apiVersion: v1\nkind: Service\nmetadata:\n name: anubis-docs\nspec:\n selector:\n app: anubis-docs\n ports:\n - port: 80\n targetPort: 80\n name: http\n - port: 8081\n targetPort: 8081\n name: anubis\n"
},
{
"path": "docs/package.json",
"content": "{\n \"name\": \"docs\",\n \"version\": \"0.0.0\",\n \"private\": true,\n \"scripts\": {\n \"docusaurus\": \"docusaurus\",\n \"start\": \"docusaurus start --host 0.0.0.0\",\n \"build\": \"docusaurus build\",\n \"swizzle\": \"docusaurus swizzle\",\n \"deploy\": \"echo 'use CI' && exit 1\",\n \"clear\": \"docusaurus clear\",\n \"serve\": \"docusaurus serve\",\n \"write-translations\": \"docusaurus write-translations\",\n \"write-heading-ids\": \"docusaurus write-heading-ids\",\n \"typecheck\": \"tsc\"\n },\n \"dependencies\": {\n \"@docusaurus/core\": \"^3.8.1\",\n \"@docusaurus/preset-classic\": \"^3.8.1\",\n \"@docusaurus/theme-mermaid\": \"^3.8.1\",\n \"@mdx-js/react\": \"^3.0.0\",\n \"clsx\": \"^2.0.0\",\n \"prism-react-renderer\": \"^2.3.0\",\n \"raw-loader\": \"^4.0.2\",\n \"react\": \"^19.0.0\",\n \"react-dom\": \"^19.0.0\"\n },\n \"devDependencies\": {\n \"@docusaurus/module-type-aliases\": \"^3.0.1\",\n \"@docusaurus/tsconfig\": \"^3.8.1\",\n \"@docusaurus/types\": \"^3.8.1\",\n \"typescript\": \"~5.6.2\"\n },\n \"browserslist\": {\n \"production\": [\n \">0.5%\",\n \"not dead\",\n \"not op_mini all\"\n ],\n \"development\": [\n \"last 3 chrome version\",\n \"last 3 firefox version\",\n \"last 5 safari version\"\n ]\n },\n \"engines\": {\n \"node\": \">=18.0\"\n }\n}\n"
},
{
"path": "docs/sidebars.ts",
"content": "import type { SidebarsConfig } from \"@docusaurus/plugin-content-docs\";\n\n// This runs in Node.js - Don't use client-side code here (browser APIs, JSX...)\n\n/**\n * Creating a sidebar enables you to:\n - create an ordered group of docs\n - render a sidebar for each doc of that group\n - provide next/previous navigation\n\n The sidebars can be generated from the filesystem, or explicitly defined here.\n\n Create as many sidebars as you want.\n */\nconst sidebars: SidebarsConfig = {\n // By default, Docusaurus generates a sidebar from the docs folder structure\n tutorialSidebar: [{ type: \"autogenerated\", dirName: \".\" }],\n\n // But you can create a sidebar manually\n /*\n tutorialSidebar: [\n 'intro',\n 'hello',\n {\n type: 'category',\n label: 'Tutorial',\n items: ['tutorial-basics/create-a-document'],\n },\n ],\n */\n};\n\nexport default sidebars;\n"
},
{
"path": "docs/src/components/EnterpriseOnly/index.jsx",
"content": "import styles from \"./styles.module.css\";\n\nexport default function EnterpriseOnly({ link }) {\n return (\n <a className={styles.link} href={link}>\n <div className={styles.container}>\n <span className={styles.label}>BotStopper Only</span>\n </div>\n </a>\n );\n}\n"
},
{
"path": "docs/src/components/EnterpriseOnly/styles.module.css",
"content": ".link {\n text-decoration: none;\n}\n\n.container {\n background-color: #16a34a; /* green-500 */\n color: #ffffff;\n font-weight: 700;\n padding: 0.5rem 1rem; /* py-2 px-4 */\n border-radius: 9999px; /* rounded-full */\n box-shadow:\n 0 10px 15px -3px rgba(0, 0, 0, 0.1),\n 0 4px 6px -2px rgba(0, 0, 0, 0.05); /* shadow-lg approximation */\n display: inline-flex; /* flex */\n align-items: center; /* items-center */\n}\n\n.label {\n line-height: 1;\n}\n"
},
{
"path": "docs/src/components/HomepageFeatures/index.tsx",
"content": "import type { ReactNode } from \"react\";\nimport clsx from \"clsx\";\nimport Heading from \"@theme/Heading\";\nimport styles from \"./styles.module.css\";\n\ntype FeatureItem = {\n title: string;\n imageURL: string;\n description: ReactNode;\n};\n\nconst FeatureList: FeatureItem[] = [\n {\n title: \"Easy to Use\",\n imageURL: require(\"@site/static/img/anubis/happy.webp\").default,\n description: (\n <>\n Anubis sits in the background and weighs the risk of incoming requests.\n If it asks a client to complete a challenge, no user interaction is\n required.\n </>\n ),\n },\n {\n title: \"Lightweight\",\n imageURL: require(\"@site/static/img/anubis/pensive.webp\").default,\n description: (\n <>\n Anubis is so lightweight you'll forget it's there until you look at your\n hosting bill. On average it uses less than 128 MB of ram.\n </>\n ),\n },\n {\n title: \"Block the scrapers\",\n imageURL: require(\"@site/static/img/anubis/reject.webp\").default,\n description: (\n <>\n Anubis uses a combination of heuristics to identify and block bots\n before they take your website down. You can customize the rules with{\" \"}\n <a href=\"/docs/admin/policies\">your own policies</a>.\n </>\n ),\n },\n];\n\nfunction Feature({ title, description, imageURL }: FeatureItem) {\n return (\n <div className={clsx(\"col col--4\")}>\n <div className=\"text--center\">\n <img src={imageURL} className={styles.featureSvg} role=\"img\" />\n </div>\n <div className=\"text--center padding-horiz--md\">\n <Heading as=\"h3\">{title}</Heading>\n <p>{description}</p>\n </div>\n </div>\n );\n}\n\nexport default function HomepageFeatures(): ReactNode {\n return (\n <section className={styles.features}>\n <div className=\"container\">\n <div className=\"row\">\n {FeatureList.map((props, idx) => (\n <Feature key={idx} {...props} />\n ))}\n </div>\n </div>\n </section>\n );\n}\n"
},
{
"path": "docs/src/components/HomepageFeatures/styles.module.css",
"content": ".features {\n display: flex;\n align-items: center;\n padding: 2rem 0;\n width: 100%;\n}\n\n.featureSvg {\n height: 200px;\n width: 200px;\n}\n"
},
{
"path": "docs/src/components/RandomKey/index.tsx",
"content": "import { useState, useCallback } from \"react\";\nimport Code from \"@theme/CodeInline\";\nimport BrowserOnly from \"@docusaurus/BrowserOnly\";\n\n// https://www.xaymar.com/articles/2020/12/08/fastest-uint8array-to-hex-string-conversion-in-javascript/\nfunction toHex(buffer) {\n return Array.prototype.map\n .call(buffer, (x) => (\"00\" + x.toString(16)).slice(-2))\n .join(\"\");\n}\n\nexport const genRandomKey = (): String => {\n const array = new Uint8Array(32);\n self.crypto.getRandomValues(array);\n return toHex(array);\n};\n\nexport default function RandomKey() {\n return (\n <BrowserOnly fallback={<div>Loading...</div>}>\n {() => {\n const [key, setKey] = useState<String>(genRandomKey());\n const genRandomKeyCb = useCallback(() => {\n setKey(genRandomKey());\n });\n return (\n <span>\n <Code>{key}</Code>\n <span style={{ marginLeft: \"0.25rem\", marginRight: \"0.25rem\" }} />\n <button\n onClick={() => {\n genRandomKeyCb();\n }}\n >\n ♻️\n </button>\n </span>\n );\n }}\n </BrowserOnly>\n );\n}\n"
},
{
"path": "docs/src/css/custom.css",
"content": "/**\n * Any CSS included here will be global. The classic template\n * bundles Infima by default. Infima is a CSS framework designed to\n * work well for content-centric websites.\n */\n\n/* You can override the default Infima variables here. */\n:root {\n --ifm-color-primary: #ff5630;\n --ifm-color-primary-dark: #ad422a;\n --ifm-color-primary-darker: #8f3521;\n --ifm-color-primary-darkest: #592115;\n --ifm-color-primary-light: #ff7152;\n --ifm-color-primary-lighter: #ff9178;\n --ifm-color-primary-lightest: #ffb09e;\n --ifm-code-font-size: 95%;\n --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.1);\n --code-block-diff-add-line-color: #ccffd8;\n --code-block-diff-remove-line-color: #ffebe9;\n}\n\n/* For readability concerns, you should choose a lighter palette in dark mode. */\n[data-theme=\"dark\"] {\n --ifm-color-primary: #e64a19;\n --ifm-color-primary-dark: #b73a12;\n --ifm-color-primary-darker: #8c2c0e;\n --ifm-color-primary-darkest: #5a1e0a;\n --ifm-color-primary-light: #eb6d45;\n --ifm-color-primary-lighter: #f09178;\n --ifm-color-primary-lightest: #f5b5a6;\n --ifm-code-font-size: 95%;\n --docusaurus-highlighted-code-line-bg: rgba(0, 0, 0, 0.25);\n --code-block-diff-add-line-color: #2d5a2c;\n --code-block-diff-remove-line-color: #5a2d2c;\n}\n\n.code-block-diff-add-line {\n background-color: var(--code-block-diff-add-line-color);\n display: block;\n margin: 0 -40px;\n padding: 0 40px;\n}\n\n.code-block-diff-add-line::before {\n position: absolute;\n left: 8px;\n padding-right: 8px;\n content: \"+\";\n}\n\n.code-block-diff-remove-line {\n background-color: var(--code-block-diff-remove-line-color);\n display: block;\n margin: 0 -40px;\n padding: 0 40px;\n}\n\n.code-block-diff-remove-line::before {\n position: absolute;\n left: 8px;\n padding-right: 8px;\n content: \"-\";\n}\n\n/**\n * use magic comments to mark diff blocks\n */\npre code:has(.code-block-diff-add-line) {\n padding-left: 40px !important;\n}\n\npre code:has(.code-block-diff-remove-line) {\n padding-left: 40px !important;\n}\n"
},
{
"path": "docs/src/pages/index.module.css",
"content": "/**\n * CSS files with the .module.css suffix will be treated as CSS modules\n * and scoped locally.\n */\n\n.heroBanner {\n padding: 4rem 0;\n text-align: center;\n position: relative;\n overflow: hidden;\n}\n\n@media screen and (max-width: 996px) {\n .heroBanner {\n padding: 2rem;\n }\n}\n\n.buttons {\n display: flex;\n align-items: center;\n justify-content: center;\n}\n"
},
{
"path": "docs/src/pages/index.tsx",
"content": "import type { ReactNode } from \"react\";\nimport clsx from \"clsx\";\nimport Link from \"@docusaurus/Link\";\nimport useDocusaurusContext from \"@docusaurus/useDocusaurusContext\";\nimport Layout from \"@theme/Layout\";\nimport HomepageFeatures from \"@site/src/components/HomepageFeatures\";\nimport Heading from \"@theme/Heading\";\n\nimport styles from \"./index.module.css\";\n\nfunction HomepageHeader() {\n const { siteConfig } = useDocusaurusContext();\n return (\n <header className={clsx(\"hero hero--primary\", styles.heroBanner)}>\n <div className=\"container\">\n <Heading as=\"h1\" className=\"hero__title\">\n {siteConfig.title}\n </Heading>\n <p className=\"hero__subtitle\">{siteConfig.tagline}</p>\n <div className={styles.buttons}>\n <Link\n className=\"button button--secondary button--lg\"\n to=\"/docs/category/environments\"\n >\n Get started\n </Link>\n </div>\n </div>\n </header>\n );\n}\n\nexport default function Home(): ReactNode {\n const { siteConfig } = useDocusaurusContext();\n return (\n <Layout\n title={`Anubis: Web AI Firewall Utility`}\n description=\"Weigh the soul of incoming HTTP requests to protect your website!\"\n >\n <HomepageHeader />\n <main>\n <HomepageFeatures />\n </main>\n </Layout>\n );\n}\n"
},
{
"path": "docs/static/.nojekyll",
"content": ""
},
{
"path": "docs/tsconfig.json",
"content": "{\n // This file is not used in compilation. It is here just for a nice editor experience.\n \"extends\": \"@docusaurus/tsconfig\",\n \"compilerOptions\": {\n \"baseUrl\": \".\"\n },\n \"exclude\": [\".docusaurus\", \"build\"]\n}\n"
},
{
"path": "go.mod",
"content": "module github.com/TecharoHQ/anubis\n\ngo 1.24.2\n\nrequire (\n\tgithub.com/TecharoHQ/thoth-proto v0.5.0\n\tgithub.com/a-h/templ v0.3.960\n\tgithub.com/aws/aws-sdk-go-v2 v1.41.0\n\tgithub.com/aws/aws-sdk-go-v2/config v1.32.5\n\tgithub.com/aws/aws-sdk-go-v2/service/s3 v1.93.2\n\tgithub.com/cespare/xxhash/v2 v2.3.0\n\tgithub.com/facebookgo/flagenv v0.0.0-20160425205200-fcd59fca7456\n\tgithub.com/fahedouch/go-logrotate v0.3.0\n\tgithub.com/gaissmai/bart v0.26.0\n\tgithub.com/golang-jwt/jwt/v5 v5.3.0\n\tgithub.com/google/cel-go v0.26.1\n\tgithub.com/google/uuid v1.6.0\n\tgithub.com/grpc-ecosystem/go-grpc-middleware/providers/prometheus v1.1.0\n\tgithub.com/grpc-ecosystem/go-grpc-middleware/v2 v2.3.3\n\tgithub.com/joho/godotenv v1.5.1\n\tgithub.com/lum8rjack/go-ja4h v0.0.0-20250828030157-fa5266d50650\n\tgithub.com/nicksnyder/go-i18n/v2 v2.6.0\n\tgithub.com/nikandfor/spintax v0.0.0-20181023094358-fc346b245bb3\n\tgithub.com/playwright-community/playwright-go v0.5200.1\n\tgithub.com/prometheus/client_golang v1.23.2\n\tgithub.com/redis/go-redis/v9 v9.17.2\n\tgithub.com/sebest/xff v0.0.0-20210106013422-671bd2870b3a\n\tgithub.com/shirou/gopsutil/v4 v4.25.11\n\tgithub.com/testcontainers/testcontainers-go v0.40.0\n\tgo.etcd.io/bbolt v1.4.3\n\tgolang.org/x/net v0.48.0\n\tgolang.org/x/text v0.32.0\n\tgoogle.golang.org/grpc v1.77.0\n\tgopkg.in/yaml.v3 v3.0.1\n\tk8s.io/apimachinery v0.34.3\n\tsigs.k8s.io/yaml v1.6.0\n)\n\nrequire (\n\tal.essio.dev/pkg/shellescape v1.6.0 // indirect\n\tbuf.build/gen/go/bufbuild/protovalidate/protocolbuffers/go v1.36.11-20251209175733-2a1774d88802.1 // indirect\n\tcel.dev/expr v0.25.1 // indirect\n\tdario.cat/mergo v1.0.2 // indirect\n\tgithub.com/AlekSi/pointer v1.2.0 // indirect\n\tgithub.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c // indirect\n\tgithub.com/BurntSushi/toml v1.5.0 // indirect\n\tgithub.com/Masterminds/goutils v1.1.1 // indirect\n\tgithub.com/Masterminds/semver/v3 v3.4.0 // indirect\n\tgithub.com/Masterminds/sprig/v3 v3.3.0 // indirect\n\tgithub.com/Microsoft/go-winio v0.6.2 // indirect\n\tgithub.com/ProtonMail/go-crypto v1.3.0 // indirect\n\tgithub.com/Songmu/gitconfig v0.2.1 // indirect\n\tgithub.com/TecharoHQ/yeet v0.6.3 // indirect\n\tgithub.com/a-h/parse v0.0.0-20250122154542-74294addb73e // indirect\n\tgithub.com/andybalholm/brotli v1.2.0 // indirect\n\tgithub.com/antlr4-go/antlr/v4 v4.13.1 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.4 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/credentials v1.19.5 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.16 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/internal/configsources v1.4.16 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.16 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/internal/ini v1.8.4 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/internal/v4a v1.4.16 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.4 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.7 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.16 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.16 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/signin v1.0.4 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/sso v1.30.7 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.12 // indirect\n\tgithub.com/aws/aws-sdk-go-v2/service/sts v1.41.5 // indirect\n\tgithub.com/aws/smithy-go v1.24.0 // indirect\n\tgithub.com/beorn7/perks v1.0.1 // indirect\n\tgithub.com/blakesmith/ar v0.0.0-20190502131153-809d4375e1fb // indirect\n\tgithub.com/cavaliergopher/cpio v1.0.1 // indirect\n\tgithub.com/cenkalti/backoff/v4 v4.3.0 // indirect\n\tgithub.com/cli/browser v1.3.0 // indirect\n\tgithub.com/cli/go-gh/v2 v2.12.1 // indirect\n\tgithub.com/cli/safeexec v1.0.1 // indirect\n\tgithub.com/cloudflare/circl v1.6.1 // indirect\n\tgithub.com/containerd/errdefs v1.0.0 // indirect\n\tgithub.com/containerd/errdefs/pkg v0.3.0 // indirect\n\tgithub.com/containerd/log v0.1.0 // indirect\n\tgithub.com/containerd/platforms v0.2.1 // indirect\n\tgithub.com/cpuguy83/dockercfg v0.3.2 // indirect\n\tgithub.com/cpuguy83/go-md2man/v2 v2.0.7 // indirect\n\tgithub.com/cyphar/filepath-securejoin v0.4.1 // indirect\n\tgithub.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc // indirect\n\tgithub.com/deckarep/golang-set/v2 v2.8.0 // indirect\n\tgithub.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f // indirect\n\tgithub.com/distribution/reference v0.6.0 // indirect\n\tgithub.com/djherbis/times v1.6.0 // indirect\n\tgithub.com/dlclark/regexp2 v1.11.5 // indirect\n\tgithub.com/docker/docker v28.5.1+incompatible // indirect\n\tgithub.com/docker/go-connections v0.6.0 // indirect\n\tgithub.com/docker/go-units v0.5.0 // indirect\n\tgithub.com/dop251/goja v0.0.0-20250630131328-58d95d85e994 // indirect\n\tgithub.com/ebitengine/purego v0.9.1 // indirect\n\tgithub.com/emirpasic/gods v1.18.1 // indirect\n\tgithub.com/facebookgo/ensure v0.0.0-20160127193407-b4ab57deab51 // indirect\n\tgithub.com/facebookgo/stack v0.0.0-20160209184415-751773369052 // indirect\n\tgithub.com/facebookgo/subset v0.0.0-20150612182917-8dac2c3c4870 // indirect\n\tgithub.com/fatih/color v1.18.0 // indirect\n\tgithub.com/felixge/httpsnoop v1.0.4 // indirect\n\tgithub.com/fsnotify/fsnotify v1.9.0 // indirect\n\tgithub.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 // indirect\n\tgithub.com/go-git/go-billy/v5 v5.6.2 // indirect\n\tgithub.com/go-git/go-git/v5 v5.16.2 // indirect\n\tgithub.com/go-jose/go-jose/v3 v3.0.4 // indirect\n\tgithub.com/go-logr/logr v1.4.3 // indirect\n\tgithub.com/go-logr/stdr v1.2.2 // indirect\n\tgithub.com/go-ole/go-ole v1.3.0 // indirect\n\tgithub.com/go-sourcemap/sourcemap v2.1.4+incompatible // indirect\n\tgithub.com/go-stack/stack v1.8.1 // indirect\n\tgithub.com/gobwas/glob v0.2.3 // indirect\n\tgithub.com/goccy/go-yaml v1.18.0 // indirect\n\tgithub.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 // indirect\n\tgithub.com/google/go-github/v70 v70.0.0 // indirect\n\tgithub.com/google/go-querystring v1.1.0 // indirect\n\tgithub.com/google/pprof v0.0.0-20250630185457-6e76a2b096b5 // indirect\n\tgithub.com/google/rpmpack v0.7.1 // indirect\n\tgithub.com/goreleaser/chglog v0.7.3 // indirect\n\tgithub.com/goreleaser/fileglob v1.3.0 // indirect\n\tgithub.com/goreleaser/nfpm/v2 v2.43.0 // indirect\n\tgithub.com/hashicorp/go-version v1.7.0 // indirect\n\tgithub.com/huandu/xstrings v1.5.0 // indirect\n\tgithub.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 // indirect\n\tgithub.com/kevinburke/ssh_config v1.2.0 // indirect\n\tgithub.com/klauspost/compress v1.18.0 // indirect\n\tgithub.com/klauspost/pgzip v1.2.6 // indirect\n\tgithub.com/lufia/plan9stats v0.0.0-20250317134145-8bc96cf8fc35 // indirect\n\tgithub.com/magiconair/properties v1.8.10 // indirect\n\tgithub.com/mattn/go-colorable v0.1.14 // indirect\n\tgithub.com/mattn/go-isatty v0.0.20 // indirect\n\tgithub.com/mitchellh/copystructure v1.2.0 // indirect\n\tgithub.com/mitchellh/reflectwalk v1.0.2 // indirect\n\tgithub.com/moby/docker-image-spec v1.3.1 // indirect\n\tgithub.com/moby/go-archive v0.1.0 // indirect\n\tgithub.com/moby/patternmatcher v0.6.0 // indirect\n\tgithub.com/moby/sys/sequential v0.6.0 // indirect\n\tgithub.com/moby/sys/user v0.4.0 // indirect\n\tgithub.com/moby/sys/userns v0.1.0 // indirect\n\tgithub.com/moby/term v0.5.2 // indirect\n\tgithub.com/morikuni/aec v1.0.0 // indirect\n\tgithub.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 // indirect\n\tgithub.com/natefinch/atomic v1.0.1 // indirect\n\tgithub.com/opencontainers/go-digest v1.0.0 // indirect\n\tgithub.com/opencontainers/image-spec v1.1.1 // indirect\n\tgithub.com/pjbgf/sha1cd v0.4.0 // indirect\n\tgithub.com/pkg/errors v0.9.1 // indirect\n\tgithub.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 // indirect\n\tgithub.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 // indirect\n\tgithub.com/prometheus/client_model v0.6.2 // indirect\n\tgithub.com/prometheus/common v0.67.4 // indirect\n\tgithub.com/prometheus/procfs v0.19.2 // indirect\n\tgithub.com/russross/blackfriday/v2 v2.1.0 // indirect\n\tgithub.com/sergi/go-diff v1.4.0 // indirect\n\tgithub.com/shopspring/decimal v1.4.0 // indirect\n\tgithub.com/sirupsen/logrus v1.9.3 // indirect\n\tgithub.com/skeema/knownhosts v1.3.1 // indirect\n\tgithub.com/spf13/afero v1.14.0 // indirect\n\tgithub.com/spf13/cast v1.9.2 // indirect\n\tgithub.com/stoewer/go-strcase v1.3.1 // indirect\n\tgithub.com/stretchr/testify v1.11.1 // indirect\n\tgithub.com/suzuki-shunsuke/logrus-error v0.1.4 // indirect\n\tgithub.com/suzuki-shunsuke/pinact v1.6.0 // indirect\n\tgithub.com/suzuki-shunsuke/urfave-cli-help-all v0.0.4 // indirect\n\tgithub.com/tklauser/go-sysconf v0.3.16 // indirect\n\tgithub.com/tklauser/numcpus v0.11.0 // indirect\n\tgithub.com/ulikunitz/xz v0.5.14 // indirect\n\tgithub.com/urfave/cli/v2 v2.27.7 // indirect\n\tgithub.com/xanzy/ssh-agent v0.3.3 // indirect\n\tgithub.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 // indirect\n\tgithub.com/yusufpapurcu/wmi v1.2.4 // indirect\n\tgitlab.com/digitalxero/go-conventional-commit v1.0.7 // indirect\n\tgo.opentelemetry.io/auto/sdk v1.2.1 // indirect\n\tgo.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.62.0 // indirect\n\tgo.opentelemetry.io/otel v1.38.0 // indirect\n\tgo.opentelemetry.io/otel/exporters/otlp/otlptrace v1.37.0 // indirect\n\tgo.opentelemetry.io/otel/metric v1.38.0 // indirect\n\tgo.opentelemetry.io/otel/trace v1.38.0 // indirect\n\tgo.opentelemetry.io/proto/otlp v1.7.0 // indirect\n\tgo.yaml.in/yaml/v2 v2.4.3 // indirect\n\tgo.yaml.in/yaml/v3 v3.0.4 // indirect\n\tgolang.org/x/crypto v0.46.0 // indirect\n\tgolang.org/x/exp v0.0.0-20251209150349-8475f28825e9 // indirect\n\tgolang.org/x/exp/typeparams v0.0.0-20250718183923-645b1fa84792 // indirect\n\tgolang.org/x/mod v0.31.0 // indirect\n\tgolang.org/x/oauth2 v0.32.0 // indirect\n\tgolang.org/x/sync v0.19.0 // indirect\n\tgolang.org/x/sys v0.39.0 // indirect\n\tgolang.org/x/telemetry v0.0.0-20251203150158-8fff8a5912fc // indirect\n\tgolang.org/x/term v0.38.0 // indirect\n\tgolang.org/x/tools v0.40.0 // indirect\n\tgolang.org/x/vuln v1.1.4 // indirect\n\tgoogle.golang.org/genproto/googleapis/api v0.0.0-20251213004720-97cd9d5aeac2 // indirect\n\tgoogle.golang.org/genproto/googleapis/rpc v0.0.0-20251213004720-97cd9d5aeac2 // indirect\n\tgoogle.golang.org/protobuf v1.36.11 // indirect\n\tgopkg.in/warnings.v0 v0.1.2 // indirect\n\thonnef.co/go/tools v0.6.1 // indirect\n\tmvdan.cc/sh/v3 v3.12.0 // indirect\n\tsigs.k8s.io/json v0.0.0-20250730193827-2d320260d730 // indirect\n)\n\ntool (\n\tgithub.com/TecharoHQ/yeet/cmd/yeet\n\tgithub.com/a-h/templ/cmd/templ\n\tgithub.com/nicksnyder/go-i18n/v2/goi18n\n\tgithub.com/suzuki-shunsuke/pinact/cmd/pinact\n\tgolang.org/x/tools/cmd/deadcode\n\tgolang.org/x/tools/cmd/goimports\n\tgolang.org/x/tools/cmd/stringer\n\tgolang.org/x/vuln/cmd/govulncheck\n\thonnef.co/go/tools/cmd/staticcheck\n)\n"
},
{
"path": "go.sum",
"content": "al.essio.dev/pkg/shellescape v1.6.0 h1:NxFcEqzFSEVCGN2yq7Huv/9hyCEGVa/TncnOOBBeXHA=\nal.essio.dev/pkg/shellescape v1.6.0/go.mod h1:6sIqp7X2P6mThCQ7twERpZTuigpr6KbZWtls1U8I890=\nbuf.build/gen/go/bufbuild/protovalidate/protocolbuffers/go v1.36.11-20251209175733-2a1774d88802.1 h1:j9yeqTWEFrtimt8Nng2MIeRrpoCvQzM9/g25XTvqUGg=\nbuf.build/gen/go/bufbuild/protovalidate/protocolbuffers/go v1.36.11-20251209175733-2a1774d88802.1/go.mod h1:tvtbpgaVXZX4g6Pn+AnzFycuRK3MOz5HJfEGeEllXYM=\ncel.dev/expr v0.25.1 h1:1KrZg61W6TWSxuNZ37Xy49ps13NUovb66QLprthtwi4=\ncel.dev/expr v0.25.1/go.mod h1:hrXvqGP6G6gyx8UAHSHJ5RGk//1Oj5nXQ2NI02Nrsg4=\ndario.cat/mergo v1.0.2 h1:85+piFYR1tMbRrLcDwR18y4UKJ3aH1Tbzi24VRW1TK8=\ndario.cat/mergo v1.0.2/go.mod h1:E/hbnu0NxMFBjpMIE34DRGLWqDy0g5FuKDhCb31ngxA=\ngithub.com/AdaLogics/go-fuzz-headers v0.0.0-20240806141605-e8a1dd7889d6 h1:He8afgbRMd7mFxO99hRNu+6tazq8nFF9lIwo9JFroBk=\ngithub.com/AdaLogics/go-fuzz-headers v0.0.0-20240806141605-e8a1dd7889d6/go.mod h1:8o94RPi1/7XTJvwPpRSzSUedZrtlirdB3r9Z20bi2f8=\ngithub.com/AlekSi/pointer v1.2.0 h1:glcy/gc4h8HnG2Z3ZECSzZ1IX1x2JxRVuDzaJwQE0+w=\ngithub.com/AlekSi/pointer v1.2.0/go.mod h1:gZGfd3dpW4vEc/UlyfKKi1roIqcCgwOIvb0tSNSBle0=\ngithub.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c h1:udKWzYgxTojEKWjV8V+WSxDXJ4NFATAsZjh8iIbsQIg=\ngithub.com/Azure/go-ansiterm v0.0.0-20250102033503-faa5f7b0171c/go.mod h1:xomTg63KZ2rFqZQzSB4Vz2SUXa1BpHTVz9L5PTmPC4E=\ngithub.com/BurntSushi/toml v1.5.0 h1:W5quZX/G/csjUnuI8SUYlsHs9M38FC7znL0lIO+DvMg=\ngithub.com/BurntSushi/toml v1.5.0/go.mod h1:ukJfTF/6rtPPRCnwkur4qwRxa8vTRFBF0uk2lLoLwho=\ngithub.com/DataDog/zstd v1.5.5 h1:oWf5W7GtOLgp6bciQYDmhHHjdhYkALu6S/5Ni9ZgSvQ=\ngithub.com/DataDog/zstd v1.5.5/go.mod h1:g4AWEaM3yOg3HYfnJ3YIawPnVdXJh9QME85blwSAmyw=\ngithub.com/Masterminds/goutils v1.1.1 h1:5nUrii3FMTL5diU80unEVvNevw1nH4+ZV4DSLVJLSYI=\ngithub.com/Masterminds/goutils v1.1.1/go.mod h1:8cTjp+g8YejhMuvIA5y2vz3BpJxksy863GQaJW2MFNU=\ngithub.com/Masterminds/semver/v3 v3.4.0 h1:Zog+i5UMtVoCU8oKka5P7i9q9HgrJeGzI9SA1Xbatp0=\ngithub.com/Masterminds/semver/v3 v3.4.0/go.mod h1:4V+yj/TJE1HU9XfppCwVMZq3I84lprf4nC11bSS5beM=\ngithub.com/Masterminds/sprig/v3 v3.3.0 h1:mQh0Yrg1XPo6vjYXgtf5OtijNAKJRNcTdOOGZe3tPhs=\ngithub.com/Masterminds/sprig/v3 v3.3.0/go.mod h1:Zy1iXRYNqNLUolqCpL4uhk6SHUMAOSCzdgBfDb35Lz0=\ngithub.com/Microsoft/go-winio v0.5.2/go.mod h1:WpS1mjBmmwHBEWmogvA2mj8546UReBk4v8QkMxJ6pZY=\ngithub.com/Microsoft/go-winio v0.6.2 h1:F2VQgta7ecxGYO8k3ZZz3RS8fVIXVxONVUPlNERoyfY=\ngithub.com/Microsoft/go-winio v0.6.2/go.mod h1:yd8OoFMLzJbo9gZq8j5qaps8bJ9aShtEA8Ipt1oGCvU=\ngithub.com/ProtonMail/go-crypto v1.3.0 h1:ILq8+Sf5If5DCpHQp4PbZdS1J7HDFRXz/+xKBiRGFrw=\ngithub.com/ProtonMail/go-crypto v1.3.0/go.mod h1:9whxjD8Rbs29b4XWbB8irEcE8KHMqaR2e7GWU1R+/PE=\ngithub.com/ProtonMail/go-mime v0.0.0-20230322103455-7d82a3887f2f h1:tCbYj7/299ekTTXpdwKYF8eBlsYsDVoggDAuAjoK66k=\ngithub.com/ProtonMail/go-mime v0.0.0-20230322103455-7d82a3887f2f/go.mod h1:gcr0kNtGBqin9zDW9GOHcVntrwnjrK+qdJ06mWYBybw=\ngithub.com/ProtonMail/gopenpgp/v2 v2.7.1 h1:Awsg7MPc2gD3I7IFac2qE3Gdls0lZW8SzrFZ3k1oz0s=\ngithub.com/ProtonMail/gopenpgp/v2 v2.7.1/go.mod h1:/BU5gfAVwqyd8EfC3Eu7zmuhwYQpKs+cGD8M//iiaxs=\ngithub.com/ProtonMail/gopenpgp/v3 v3.3.0 h1:N6rHCH5PWwB6zSRMgRj1EbAMQHUAAHxH3Oo4KibsPwY=\ngithub.com/ProtonMail/gopenpgp/v3 v3.3.0/go.mod h1:J+iNPt0/5EO9wRt7Eit9dRUlzyu3hiGX3zId6iuaKOk=\ngithub.com/Songmu/gitconfig v0.2.1 h1:cZsqELfMtxWVI8ovq17gbvsR4qLfoYLAiXy5GwtJWbk=\ngithub.com/Songmu/gitconfig v0.2.1/go.mod h1:XM4O3SoXFnli9Ql2G7qXK2Fg7LJwf7Hs8GLFEOJlzmM=\ngithub.com/TecharoHQ/thoth-proto v0.5.0 h1:Fa663s4soYiURSU8MfW9tZ2wF+LsCRSaYmjUSyagfBM=\ngithub.com/TecharoHQ/thoth-proto v0.5.0/go.mod h1:C/U7FqTxpVn4V/qebC/GcW32I0h9xzsmWehF27KFOJs=\ngithub.com/TecharoHQ/yeet v0.6.3 h1:Iev6TYt/tpFYU73kbkNIYjCObYTvlihtby+htGF4Us8=\ngithub.com/TecharoHQ/yeet v0.6.3/go.mod h1:ltt+PWPjnvmQJxEHsdJ5K9u3GoWK83vSLWCCp8XbxqI=\ngithub.com/a-h/parse v0.0.0-20250122154542-74294addb73e h1:HjVbSQHy+dnlS6C3XajZ69NYAb5jbGNfHanvm1+iYlo=\ngithub.com/a-h/parse v0.0.0-20250122154542-74294addb73e/go.mod h1:3mnrkvGpurZ4ZrTDbYU84xhwXW2TjTKShSwjRi2ihfQ=\ngithub.com/a-h/templ v0.3.960 h1:trshEpGa8clF5cdI39iY4ZrZG8Z/QixyzEyUnA7feTM=\ngithub.com/a-h/templ v0.3.960/go.mod h1:oCZcnKRf5jjsGpf2yELzQfodLphd2mwecwG4Crk5HBo=\ngithub.com/andybalholm/brotli v1.2.0 h1:ukwgCxwYrmACq68yiUqwIWnGY0cTPox/M94sVwToPjQ=\ngithub.com/andybalholm/brotli v1.2.0/go.mod h1:rzTDkvFWvIrjDXZHkuS16NPggd91W3kUSvPlQ1pLaKY=\ngithub.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be h1:9AeTilPcZAjCFIImctFaOjnTIavg87rW78vTPkQqLI8=\ngithub.com/anmitsu/go-shlex v0.0.0-20200514113438-38f4b401e2be/go.mod h1:ySMOLuWl6zY27l47sB3qLNK6tF2fkHG55UZxx8oIVo4=\ngithub.com/antlr4-go/antlr/v4 v4.13.1 h1:SqQKkuVZ+zWkMMNkjy5FZe5mr5WURWnlpmOuzYWrPrQ=\ngithub.com/antlr4-go/antlr/v4 v4.13.1/go.mod h1:GKmUxMtwp6ZgGwZSva4eWPC5mS6vUAmOABFgjdkM7Nw=\ngithub.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5 h1:0CwZNZbxp69SHPdPJAN/hZIm0C4OItdklCFmMRWYpio=\ngithub.com/armon/go-socks5 v0.0.0-20160902184237-e75332964ef5/go.mod h1:wHh0iHkYZB8zMSxRWpUBQtwG5a7fFgvEO+odwuTv2gs=\ngithub.com/aws/aws-sdk-go-v2 v1.41.0 h1:tNvqh1s+v0vFYdA1xq0aOJH+Y5cRyZ5upu6roPgPKd4=\ngithub.com/aws/aws-sdk-go-v2 v1.41.0/go.mod h1:MayyLB8y+buD9hZqkCW3kX1AKq07Y5pXxtgB+rRFhz0=\ngithub.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.4 h1:489krEF9xIGkOaaX3CE/Be2uWjiXrkCH6gUX+bZA/BU=\ngithub.com/aws/aws-sdk-go-v2/aws/protocol/eventstream v1.7.4/go.mod h1:IOAPF6oT9KCsceNTvvYMNHy0+kMF8akOjeDvPENWxp4=\ngithub.com/aws/aws-sdk-go-v2/config v1.32.5 h1:pz3duhAfUgnxbtVhIK39PGF/AHYyrzGEyRD9Og0QrE8=\ngithub.com/aws/aws-sdk-go-v2/config v1.32.5/go.mod h1:xmDjzSUs/d0BB7ClzYPAZMmgQdrodNjPPhd6bGASwoE=\ngithub.com/aws/aws-sdk-go-v2/credentials v1.19.5 h1:xMo63RlqP3ZZydpJDMBsH9uJ10hgHYfQFIk1cHDXrR4=\ngithub.com/aws/aws-sdk-go-v2/credentials v1.19.5/go.mod h1:hhbH6oRcou+LpXfA/0vPElh/e0M3aFeOblE1sssAAEk=\ngithub.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.16 h1:80+uETIWS1BqjnN9uJ0dBUaETh+P1XwFy5vwHwK5r9k=\ngithub.com/aws/aws-sdk-go-v2/feature/ec2/imds v1.18.16/go.mod h1:wOOsYuxYuB/7FlnVtzeBYRcjSRtQpAW0hCP7tIULMwo=\ngithub.com/aws/aws-sdk-go-v2/internal/configsources v1.4.16 h1:rgGwPzb82iBYSvHMHXc8h9mRoOUBZIGFgKb9qniaZZc=\ngithub.com/aws/aws-sdk-go-v2/internal/configsources v1.4.16/go.mod h1:L/UxsGeKpGoIj6DxfhOWHWQ/kGKcd4I1VncE4++IyKA=\ngithub.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.16 h1:1jtGzuV7c82xnqOVfx2F0xmJcOw5374L7N6juGW6x6U=\ngithub.com/aws/aws-sdk-go-v2/internal/endpoints/v2 v2.7.16/go.mod h1:M2E5OQf+XLe+SZGmmpaI2yy+J326aFf6/+54PoxSANc=\ngithub.com/aws/aws-sdk-go-v2/internal/ini v1.8.4 h1:WKuaxf++XKWlHWu9ECbMlha8WOEGm0OUEZqm4K/Gcfk=\ngithub.com/aws/aws-sdk-go-v2/internal/ini v1.8.4/go.mod h1:ZWy7j6v1vWGmPReu0iSGvRiise4YI5SkR3OHKTZ6Wuc=\ngithub.com/aws/aws-sdk-go-v2/internal/v4a v1.4.16 h1:CjMzUs78RDDv4ROu3JnJn/Ig1r6ZD7/T2DXLLRpejic=\ngithub.com/aws/aws-sdk-go-v2/internal/v4a v1.4.16/go.mod h1:uVW4OLBqbJXSHJYA9svT9BluSvvwbzLQ2Crf6UPzR3c=\ngithub.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.4 h1:0ryTNEdJbzUCEWkVXEXoqlXV72J5keC1GvILMOuD00E=\ngithub.com/aws/aws-sdk-go-v2/service/internal/accept-encoding v1.13.4/go.mod h1:HQ4qwNZh32C3CBeO6iJLQlgtMzqeG17ziAA/3KDJFow=\ngithub.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.7 h1:DIBqIrJ7hv+e4CmIk2z3pyKT+3B6qVMgRsawHiR3qso=\ngithub.com/aws/aws-sdk-go-v2/service/internal/checksum v1.9.7/go.mod h1:vLm00xmBke75UmpNvOcZQ/Q30ZFjbczeLFqGx5urmGo=\ngithub.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.16 h1:oHjJHeUy0ImIV0bsrX0X91GkV5nJAyv1l1CC9lnO0TI=\ngithub.com/aws/aws-sdk-go-v2/service/internal/presigned-url v1.13.16/go.mod h1:iRSNGgOYmiYwSCXxXaKb9HfOEj40+oTKn8pTxMlYkRM=\ngithub.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.16 h1:NSbvS17MlI2lurYgXnCOLvCFX38sBW4eiVER7+kkgsU=\ngithub.com/aws/aws-sdk-go-v2/service/internal/s3shared v1.19.16/go.mod h1:SwT8Tmqd4sA6G1qaGdzWCJN99bUmPGHfRwwq3G5Qb+A=\ngithub.com/aws/aws-sdk-go-v2/service/s3 v1.93.2 h1:U3ygWUhCpiSPYSHOrRhb3gOl9T5Y3kB8k5Vjs//57bE=\ngithub.com/aws/aws-sdk-go-v2/service/s3 v1.93.2/go.mod h1:79S2BdqCJpScXZA2y+cpZuocWsjGjJINyXnOsf5DTz8=\ngithub.com/aws/aws-sdk-go-v2/service/signin v1.0.4 h1:HpI7aMmJ+mm1wkSHIA2t5EaFFv5EFYXePW30p1EIrbQ=\ngithub.com/aws/aws-sdk-go-v2/service/signin v1.0.4/go.mod h1:C5RdGMYGlfM0gYq/tifqgn4EbyX99V15P2V3R+VHbQU=\ngithub.com/aws/aws-sdk-go-v2/service/sso v1.30.7 h1:eYnlt6QxnFINKzwxP5/Ucs1vkG7VT3Iezmvfgc2waUw=\ngithub.com/aws/aws-sdk-go-v2/service/sso v1.30.7/go.mod h1:+fWt2UHSb4kS7Pu8y+BMBvJF0EWx+4H0hzNwtDNRTrg=\ngithub.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.12 h1:AHDr0DaHIAo8c9t1emrzAlVDFp+iMMKnPdYy6XO4MCE=\ngithub.com/aws/aws-sdk-go-v2/service/ssooidc v1.35.12/go.mod h1:GQ73XawFFiWxyWXMHWfhiomvP3tXtdNar/fi8z18sx0=\ngithub.com/aws/aws-sdk-go-v2/service/sts v1.41.5 h1:SciGFVNZ4mHdm7gpD1dgZYnCuVdX1s+lFTg4+4DOy70=\ngithub.com/aws/aws-sdk-go-v2/service/sts v1.41.5/go.mod h1:iW40X4QBmUxdP+fZNOpfmkdMZqsovezbAeO+Ubiv2pk=\ngithub.com/aws/smithy-go v1.24.0 h1:LpilSUItNPFr1eY85RYgTIg5eIEPtvFbskaFcmmIUnk=\ngithub.com/aws/smithy-go v1.24.0/go.mod h1:LEj2LM3rBRQJxPZTB4KuzZkaZYnZPnvgIhb4pu07mx0=\ngithub.com/beorn7/perks v1.0.1 h1:VlbKKnNfV8bJzeqoa4cOKqO6bYr3WgKZxO8Z16+hsOM=\ngithub.com/beorn7/perks v1.0.1/go.mod h1:G2ZrVWU2WbWT9wwq4/hrbKbnv/1ERSJQ0ibhJ6rlkpw=\ngithub.com/blakesmith/ar v0.0.0-20190502131153-809d4375e1fb h1:m935MPodAbYS46DG4pJSv7WO+VECIWUQ7OJYSoTrMh4=\ngithub.com/blakesmith/ar v0.0.0-20190502131153-809d4375e1fb/go.mod h1:PkYb9DJNAwrSvRx5DYA+gUcOIgTGVMNkfSCbZM8cWpI=\ngithub.com/bsm/ginkgo/v2 v2.12.0 h1:Ny8MWAHyOepLGlLKYmXG4IEkioBysk6GpaRTLC8zwWs=\ngithub.com/bsm/ginkgo/v2 v2.12.0/go.mod h1:SwYbGRRDovPVboqFv0tPTcG1sN61LM1Z4ARdbAV9g4c=\ngithub.com/bsm/gomega v1.27.10 h1:yeMWxP2pV2fG3FgAODIY8EiRE3dy0aeFYt4l7wh6yKA=\ngithub.com/bsm/gomega v1.27.10/go.mod h1:JyEr/xRbxbtgWNi8tIEVPUYZ5Dzef52k01W3YH0H+O0=\ngithub.com/caarlos0/testfs v0.4.4 h1:3PHvzHi5Lt+g332CiShwS8ogTgS3HjrmzZxCm6JCDr8=\ngithub.com/caarlos0/testfs v0.4.4/go.mod h1:bRN55zgG4XCUVVHZCeU+/Tz1Q6AxEJOEJTliBy+1DMk=\ngithub.com/cavaliergopher/cpio v1.0.1 h1:KQFSeKmZhv0cr+kawA3a0xTQCU4QxXF1vhU7P7av2KM=\ngithub.com/cavaliergopher/cpio v1.0.1/go.mod h1:pBdaqQjnvXxdS/6CvNDwIANIFSP0xRKI16PX4xejRQc=\ngithub.com/cavaliergopher/rpm v1.3.0 h1:UHX46sasX8MesUXXQ+UbkFLUX4eUWTlEcX8jcnRBIgI=\ngithub.com/cavaliergopher/rpm v1.3.0/go.mod h1:vEumo1vvtrHM1Ov86f6+k8j7zNKOxQfHDCAIcR/36ZI=\ngithub.com/cenkalti/backoff/v4 v4.3.0 h1:MyRJ/UdXutAwSAT+s3wNd7MfTIcy71VQueUuFK343L8=\ngithub.com/cenkalti/backoff/v4 v4.3.0/go.mod h1:Y3VNntkOUPxTVeUxJ/G5vcM//AlwfmyYozVcomhLiZE=\ngithub.com/cespare/xxhash/v2 v2.3.0 h1:UL815xU9SqsFlibzuggzjXhog7bL6oX9BbNZnL2UFvs=\ngithub.com/cespare/xxhash/v2 v2.3.0/go.mod h1:VGX0DQ3Q6kWi7AoAeZDth3/j3BFtOZR5XLFGgcrjCOs=\ngithub.com/cli/browser v1.3.0 h1:LejqCrpWr+1pRqmEPDGnTZOjsMe7sehifLynZJuqJpo=\ngithub.com/cli/browser v1.3.0/go.mod h1:HH8s+fOAxjhQoBUAsKuPCbqUuxZDhQ2/aD+SzsEfBTk=\ngithub.com/cli/go-gh/v2 v2.12.1 h1:SVt1/afj5FRAythyMV3WJKaUfDNsxXTIe7arZbwTWKA=\ngithub.com/cli/go-gh/v2 v2.12.1/go.mod h1:+5aXmEOJsH9fc9mBHfincDwnS02j2AIA/DsTH0Bk5uw=\ngithub.com/cli/safeexec v1.0.1 h1:e/C79PbXF4yYTN/wauC4tviMxEV13BwljGj0N9j+N00=\ngithub.com/cli/safeexec v1.0.1/go.mod h1:Z/D4tTN8Vs5gXYHDCbaM1S/anmEDnJb1iW0+EJ5zx3Q=\ngithub.com/cloudflare/circl v1.6.1 h1:zqIqSPIndyBh1bjLVVDHMPpVKqp8Su/V+6MeDzzQBQ0=\ngithub.com/cloudflare/circl v1.6.1/go.mod h1:uddAzsPgqdMAYatqJ0lsjX1oECcQLIlRpzZh3pJrofs=\ngithub.com/containerd/errdefs v1.0.0 h1:tg5yIfIlQIrxYtu9ajqY42W3lpS19XqdxRQeEwYG8PI=\ngithub.com/containerd/errdefs v1.0.0/go.mod h1:+YBYIdtsnF4Iw6nWZhJcqGSg/dwvV7tyJ/kCkyJ2k+M=\ngithub.com/containerd/errdefs/pkg v0.3.0 h1:9IKJ06FvyNlexW690DXuQNx2KA2cUJXx151Xdx3ZPPE=\ngithub.com/containerd/errdefs/pkg v0.3.0/go.mod h1:NJw6s9HwNuRhnjJhM7pylWwMyAkmCQvQ4GpJHEqRLVk=\ngithub.com/containerd/log v0.1.0 h1:TCJt7ioM2cr/tfR8GPbGf9/VRAX8D2B4PjzCpfX540I=\ngithub.com/containerd/log v0.1.0/go.mod h1:VRRf09a7mHDIRezVKTRCrOq78v577GXq3bSa3EhrzVo=\ngithub.com/containerd/platforms v0.2.1 h1:zvwtM3rz2YHPQsF2CHYM8+KtB5dvhISiXh5ZpSBQv6A=\ngithub.com/containerd/platforms v0.2.1/go.mod h1:XHCb+2/hzowdiut9rkudds9bE5yJ7npe7dG/wG+uFPw=\ngithub.com/cpuguy83/dockercfg v0.3.2 h1:DlJTyZGBDlXqUZ2Dk2Q3xHs/FtnooJJVaad2S9GKorA=\ngithub.com/cpuguy83/dockercfg v0.3.2/go.mod h1:sugsbF4//dDlL/i+S+rtpIWp+5h0BHJHfjj5/jFyUJc=\ngithub.com/cpuguy83/go-md2man/v2 v2.0.7 h1:zbFlGlXEAKlwXpmvle3d8Oe3YnkKIK4xSRTd3sHPnBo=\ngithub.com/cpuguy83/go-md2man/v2 v2.0.7/go.mod h1:oOW0eioCTA6cOiMLiUPZOpcVxMig6NIQQ7OS05n1F4g=\ngithub.com/creack/pty v1.1.24 h1:bJrF4RRfyJnbTJqzRLHzcGaZK1NeM5kTC9jGgovnR1s=\ngithub.com/creack/pty v1.1.24/go.mod h1:08sCNb52WyoAwi2QDyzUCTgcvVFhUzewun7wtTfvcwE=\ngithub.com/cyphar/filepath-securejoin v0.4.1 h1:JyxxyPEaktOD+GAnqIqTf9A8tHyAG22rowi7HkoSU1s=\ngithub.com/cyphar/filepath-securejoin v0.4.1/go.mod h1:Sdj7gXlvMcPZsbhwhQ33GguGLDGQL7h7bg04C/+u9jI=\ngithub.com/davecgh/go-spew v1.1.0/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=\ngithub.com/davecgh/go-spew v1.1.1/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=\ngithub.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc h1:U9qPSI2PIWSS1VwoXQT9A3Wy9MM3WgvqSxFWenqJduM=\ngithub.com/davecgh/go-spew v1.1.2-0.20180830191138-d8f796af33cc/go.mod h1:J7Y8YcW2NihsgmVo/mv3lAwl/skON4iLHjSsI+c5H38=\ngithub.com/deckarep/golang-set/v2 v2.8.0 h1:swm0rlPCmdWn9mESxKOjWk8hXSqoxOp+ZlfuyaAdFlQ=\ngithub.com/deckarep/golang-set/v2 v2.8.0/go.mod h1:VAky9rY/yGXJOLEDv3OMci+7wtDpOF4IN+y82NBOac4=\ngithub.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f h1:lO4WD4F/rVNCu3HqELle0jiPLLBs70cWOduZpkS1E78=\ngithub.com/dgryski/go-rendezvous v0.0.0-20200823014737-9f7001d12a5f/go.mod h1:cuUVRXasLTGF7a8hSLbxyZXjz+1KgoB3wDUb6vlszIc=\ngithub.com/distribution/reference v0.6.0 h1:0IXCQ5g4/QMHHkarYzh5l+u8T3t73zM5QvfrDyIgxBk=\ngithub.com/distribution/reference v0.6.0/go.mod h1:BbU0aIcezP1/5jX/8MP0YiH4SdvB5Y4f/wlDRiLyi3E=\ngithub.com/djherbis/times v1.6.0 h1:w2ctJ92J8fBvWPxugmXIv7Nz7Q3iDMKNx9v5ocVH20c=\ngithub.com/djherbis/times v1.6.0/go.mod h1:gOHeRAz2h+VJNZ5Gmc/o7iD9k4wW7NMVqieYCY99oc0=\ngithub.com/dlclark/regexp2 v1.11.5 h1:Q/sSnsKerHeCkc/jSTNq1oCm7KiVgUMZRDUoRu0JQZQ=\ngithub.com/dlclark/regexp2 v1.11.5/go.mod h1:DHkYz0B9wPfa6wondMfaivmHpzrQ3v9q8cnmRbL6yW8=\ngithub.com/docker/docker v28.5.1+incompatible h1:Bm8DchhSD2J6PsFzxC35TZo4TLGR2PdW/E69rU45NhM=\ngithub.com/docker/docker v28.5.1+incompatible/go.mod h1:eEKB0N0r5NX/I1kEveEz05bcu8tLC/8azJZsviup8Sk=\ngithub.com/docker/go-connections v0.6.0 h1:LlMG9azAe1TqfR7sO+NJttz1gy6KO7VJBh+pMmjSD94=\ngithub.com/docker/go-connections v0.6.0/go.mod h1:AahvXYshr6JgfUJGdDCs2b5EZG/vmaMAntpSFH5BFKE=\ngithub.com/docker/go-units v0.5.0 h1:69rxXcBk27SvSaaxTtLh/8llcHD8vYHT7WSdRZ/jvr4=\ngithub.com/docker/go-units v0.5.0/go.mod h1:fgPhTUdO+D/Jk86RDLlptpiXQzgHJF7gydDDbaIK4Dk=\ngithub.com/dop251/goja v0.0.0-20250630131328-58d95d85e994 h1:aQYWswi+hRL2zJqGacdCZx32XjKYV8ApXFGntw79XAM=\ngithub.com/dop251/goja v0.0.0-20250630131328-58d95d85e994/go.mod h1:MxLav0peU43GgvwVgNbLAj1s/bSGboKkhuULvq/7hx4=\ngithub.com/ebitengine/purego v0.9.1 h1:a/k2f2HQU3Pi399RPW1MOaZyhKJL9w/xFpKAg4q1s0A=\ngithub.com/ebitengine/purego v0.9.1/go.mod h1:iIjxzd6CiRiOG0UyXP+V1+jWqUXVjPKLAI0mRfJZTmQ=\ngithub.com/elazarl/goproxy v1.7.2 h1:Y2o6urb7Eule09PjlhQRGNsqRfPmYI3KKQLFpCAV3+o=\ngithub.com/elazarl/goproxy v1.7.2/go.mod h1:82vkLNir0ALaW14Rc399OTTjyNREgmdL2cVoIbS6XaE=\ngithub.com/emirpasic/gods v1.18.1 h1:FXtiHYKDGKCW2KzwZKx0iC0PQmdlorYgdFG9jPXJ1Bc=\ngithub.com/emirpasic/gods v1.18.1/go.mod h1:8tpGGwCnJ5H4r6BWwaV6OrWmMoPhUl5jm/FMNAnJvWQ=\ngithub.com/facebookgo/ensure v0.0.0-20160127193407-b4ab57deab51 h1:0JZ+dUmQeA8IIVUMzysrX4/AKuQwWhV2dYQuPZdvdSQ=\ngithub.com/facebookgo/ensure v0.0.0-20160127193407-b4ab57deab51/go.mod h1:Yg+htXGokKKdzcwhuNDwVvN+uBxDGXJ7G/VN1d8fa64=\ngithub.com/facebookgo/flagenv v0.0.0-20160425205200-fcd59fca7456 h1:CkmB2l68uhvRlwOTPrwnuitSxi/S3Cg4L5QYOcL9MBc=\ngithub.com/facebookgo/flagenv v0.0.0-20160425205200-fcd59fca7456/go.mod h1:zFhibDvPDWmtk4dAQ05sRobtyoffEHygEt3wSNuAzz8=\ngithub.com/facebookgo/stack v0.0.0-20160209184415-751773369052 h1:JWuenKqqX8nojtoVVWjGfOF9635RETekkoH6Cc9SX0A=\ngithub.com/facebookgo/stack v0.0.0-20160209184415-751773369052/go.mod h1:UbMTZqLaRiH3MsBH8va0n7s1pQYcu3uTb8G4tygF4Zg=\ngithub.com/facebookgo/subset v0.0.0-20150612182917-8dac2c3c4870 h1:E2s37DuLxFhQDg5gKsWoLBOB0n+ZW8s599zru8FJ2/Y=\ngithub.com/facebookgo/subset v0.0.0-20150612182917-8dac2c3c4870/go.mod h1:5tD+neXqOorC30/tWg0LCSkrqj/AR6gu8yY8/fpw1q0=\ngithub.com/fahedouch/go-logrotate v0.3.0 h1:XP+dHIDgWZ1ckz43mG6gl5ASer3PZDVr755SVMyzaUQ=\ngithub.com/fahedouch/go-logrotate v0.3.0/go.mod h1:X49m0bvPLkk71MHNCQ1yEfVEw8W/u+qvHa/hOnhCYf4=\ngithub.com/fatih/color v1.18.0 h1:S8gINlzdQ840/4pfAwic/ZE0djQEH3wM94VfqLTZcOM=\ngithub.com/fatih/color v1.18.0/go.mod h1:4FelSpRwEGDpQ12mAdzqdOukCy4u8WUtOY6lkT/6HfU=\ngithub.com/felixge/httpsnoop v1.0.4 h1:NFTV2Zj1bL4mc9sqWACXbQFVBBg2W3GPvqp8/ESS2Wg=\ngithub.com/felixge/httpsnoop v1.0.4/go.mod h1:m8KPJKqk1gH5J9DgRY2ASl2lWCfGKXixSwevea8zH2U=\ngithub.com/frankban/quicktest v1.14.6 h1:7Xjx+VpznH+oBnejlPUj8oUpdxnVs4f8XU8WnHkI4W8=\ngithub.com/frankban/quicktest v1.14.6/go.mod h1:4ptaffx2x8+WTWXmUCuVU6aPUX1/Mz7zb5vbUoiM6w0=\ngithub.com/fsnotify/fsnotify v1.9.0 h1:2Ml+OJNzbYCTzsxtv8vKSFD9PbJjmhYF14k/jKC7S9k=\ngithub.com/fsnotify/fsnotify v1.9.0/go.mod h1:8jBTzvmWwFyi3Pb8djgCCO5IBqzKJ/Jwo8TRcHyHii0=\ngithub.com/gaissmai/bart v0.26.0 h1:xOZ57E9hJLBiQaSyeZa9wgWhGuzfGACgqp4BE77OkO0=\ngithub.com/gaissmai/bart v0.26.0/go.mod h1:GREWQfTLRWz/c5FTOsIw+KkscuFkIV5t8Rp7Nd1Td5c=\ngithub.com/gliderlabs/ssh v0.3.8 h1:a4YXD1V7xMF9g5nTkdfnja3Sxy1PVDCj1Zg4Wb8vY6c=\ngithub.com/gliderlabs/ssh v0.3.8/go.mod h1:xYoytBv1sV0aL3CavoDuJIQNURXkkfPA/wxQ1pL1fAU=\ngithub.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376 h1:+zs/tPmkDkHx3U66DAb0lQFJrpS6731Oaa12ikc+DiI=\ngithub.com/go-git/gcfg v1.5.1-0.20230307220236-3a3c6141e376/go.mod h1:an3vInlBmSxCcxctByoQdvwPiA7DTK7jaaFDBTtu0ic=\ngithub.com/go-git/go-billy/v5 v5.6.2 h1:6Q86EsPXMa7c3YZ3aLAQsMA0VlWmy43r6FHqa/UNbRM=\ngithub.com/go-git/go-billy/v5 v5.6.2/go.mod h1:rcFC2rAsp/erv7CMz9GczHcuD0D32fWzH+MJAU+jaUU=\ngithub.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399 h1:eMje31YglSBqCdIqdhKBW8lokaMrL3uTkpGYlE2OOT4=\ngithub.com/go-git/go-git-fixtures/v4 v4.3.2-0.20231010084843-55a94097c399/go.mod h1:1OCfN199q1Jm3HZlxleg+Dw/mwps2Wbk9frAWm+4FII=\ngithub.com/go-git/go-git/v5 v5.16.2 h1:fT6ZIOjE5iEnkzKyxTHK1W4HGAsPhqEqiSAssSO77hM=\ngithub.com/go-git/go-git/v5 v5.16.2/go.mod h1:4Ge4alE/5gPs30F2H1esi2gPd69R0C39lolkucHBOp8=\ngithub.com/go-jose/go-jose/v3 v3.0.4 h1:Wp5HA7bLQcKnf6YYao/4kpRpVMp/yf6+pJKV8WFSaNY=\ngithub.com/go-jose/go-jose/v3 v3.0.4/go.mod h1:5b+7YgP7ZICgJDBdfjZaIt+H/9L9T/YQrVfLAMboGkQ=\ngithub.com/go-logr/logr v1.2.2/go.mod h1:jdQByPbusPIv2/zmleS9BjJVeZ6kBagPoEUsqbVz/1A=\ngithub.com/go-logr/logr v1.4.3 h1:CjnDlHq8ikf6E492q6eKboGOC0T8CDaOvkHCIg8idEI=\ngithub.com/go-logr/logr v1.4.3/go.mod h1:9T104GzyrTigFIr8wt5mBrctHMim0Nb2HLGrmQ40KvY=\ngithub.com/go-logr/stdr v1.2.2 h1:hSWxHoqTgW2S2qGc0LTAI563KZ5YKYRhT3MFKZMbjag=\ngithub.com/go-logr/stdr v1.2.2/go.mod h1:mMo/vtBO5dYbehREoey6XUKy/eSumjCCveDpRre4VKE=\ngithub.com/go-ole/go-ole v1.2.6/go.mod h1:pprOEPIfldk/42T2oK7lQ4v4JSDwmV0As9GaiUsvbm0=\ngithub.com/go-ole/go-ole v1.3.0 h1:Dt6ye7+vXGIKZ7Xtk4s6/xVdGDQynvom7xCFEdWr6uE=\ngithub.com/go-ole/go-ole v1.3.0/go.mod h1:5LS6F96DhAwUc7C+1HLexzMXY1xGRSryjyPPKW6zv78=\ngithub.com/go-quicktest/qt v1.101.0 h1:O1K29Txy5P2OK0dGo59b7b0LR6wKfIhttaAhHUyn7eI=\ngithub.com/go-quicktest/qt v1.101.0/go.mod h1:14Bz/f7NwaXPtdYEgzsx46kqSxVwTbzVZsDC26tQJow=\ngithub.com/go-sourcemap/sourcemap v2.1.4+incompatible h1:a+iTbH5auLKxaNwQFg0B+TCYl6lbukKPc7b5x0n1s6Q=\ngithub.com/go-sourcemap/sourcemap v2.1.4+incompatible/go.mod h1:F8jJfvm2KbVjc5NqelyYJmf/v5J0dwNLS2mL4sNA1Jg=\ngithub.com/go-stack/stack v1.8.1 h1:ntEHSVwIt7PNXNpgPmVfMrNhLtgjlmnZha2kOpuRiDw=\ngithub.com/go-stack/stack v1.8.1/go.mod h1:dcoOX6HbPZSZptuspn9bctJ+N/CnF5gGygcUP3XYfe4=\ngithub.com/gobwas/glob v0.2.3 h1:A4xDbljILXROh+kObIiy5kIaPYD8e96x1tgBhUI5J+Y=\ngithub.com/gobwas/glob v0.2.3/go.mod h1:d3Ez4x06l9bZtSvzIay5+Yzi0fmZzPgnTbPcKjJAkT8=\ngithub.com/goccy/go-yaml v1.18.0 h1:8W7wMFS12Pcas7KU+VVkaiCng+kG8QiFeFwzFb+rwuw=\ngithub.com/goccy/go-yaml v1.18.0/go.mod h1:XBurs7gK8ATbW4ZPGKgcbrY1Br56PdM69F7LkFRi1kA=\ngithub.com/golang-jwt/jwt/v5 v5.3.0 h1:pv4AsKCKKZuqlgs5sUmn4x8UlGa0kEVt/puTpKx9vvo=\ngithub.com/golang-jwt/jwt/v5 v5.3.0/go.mod h1:fxCRLWMO43lRc8nhHWY6LGqRcf+1gQWArsqaEUEa5bE=\ngithub.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8 h1:f+oWsMOmNPc8JmEHVZIycC7hBoQxHH9pNKQORJNozsQ=\ngithub.com/golang/groupcache v0.0.0-20241129210726-2c02b8208cf8/go.mod h1:wcDNUvekVysuuOpQKo3191zZyTpiI6se1N1ULghS0sw=\ngithub.com/golang/protobuf v1.5.4 h1:i7eJL8qZTpSEXOPTxNKhASYpMn+8e5Q6AdndVa1dWek=\ngithub.com/golang/protobuf v1.5.4/go.mod h1:lnTiLA8Wa4RWRcIUkrtSVa5nRhsEGBg48fD6rSs7xps=\ngithub.com/google/cel-go v0.26.1 h1:iPbVVEdkhTX++hpe3lzSk7D3G3QSYqLGoHOcEio+UXQ=\ngithub.com/google/cel-go v0.26.1/go.mod h1:A9O8OU9rdvrK5MQyrqfIxo1a0u4g3sF8KB6PUIaryMM=\ngithub.com/google/go-cmdtest v0.4.1-0.20220921163831-55ab3332a786 h1:rcv+Ippz6RAtvaGgKxc+8FQIpxHgsF+HBzPyYL2cyVU=\ngithub.com/google/go-cmdtest v0.4.1-0.20220921163831-55ab3332a786/go.mod h1:apVn/GCasLZUVpAJ6oWAuyP7Ne7CEsQbTnc0plM3m+o=\ngithub.com/google/go-cmp v0.5.2/go.mod h1:v8dTdLbMG2kIc/vJvl+f65V22dbkXbowE6jgT/gNBxE=\ngithub.com/google/go-cmp v0.5.9/go.mod h1:17dUlkBOakJ0+DkrSSNjCkIjxS6bF9zb3elmeNGIjoY=\ngithub.com/google/go-cmp v0.7.0 h1:wk8382ETsv4JYUZwIsn6YpYiWiBsYLSJiTsyBybVuN8=\ngithub.com/google/go-cmp v0.7.0/go.mod h1:pXiqmnSA92OHEEa9HXL2W4E7lf9JzCmGVUdgjX3N/iU=\ngithub.com/google/go-github/v70 v70.0.0 h1:/tqCp5KPrcvqCc7vIvYyFYTiCGrYvaWoYMGHSQbo55o=\ngithub.com/google/go-github/v70 v70.0.0/go.mod h1:xBUZgo8MI3lUL/hwxl3hlceJW1U8MVnXP3zUyI+rhQY=\ngithub.com/google/go-querystring v1.1.0 h1:AnCroh3fv4ZBgVIf1Iwtovgjaw/GiKJo8M8yD/fhyJ8=\ngithub.com/google/go-querystring v1.1.0/go.mod h1:Kcdr2DB4koayq7X8pmAG4sNG59So17icRSOU623lUBU=\ngithub.com/google/pprof v0.0.0-20250630185457-6e76a2b096b5 h1:xhMrHhTJ6zxu3gA4enFM9MLn9AY7613teCdFnlUVbSQ=\ngithub.com/google/pprof v0.0.0-20250630185457-6e76a2b096b5/go.mod h1:5hDyRhoBCxViHszMt12TnOpEI4VVi+U8Gm9iphldiMA=\ngithub.com/google/renameio v0.1.0 h1:GOZbcHa3HfsPKPlmyPyN2KEohoMXOhdMbHrvbpl2QaA=\ngithub.com/google/renameio v0.1.0/go.mod h1:KWCgfxg9yswjAJkECMjeO8J8rahYeXnNhOm40UhjYkI=\ngithub.com/google/rpmpack v0.7.1 h1:YdWh1IpzOjBz60Wvdw0TU0A5NWP+JTVHA5poDqwMO2o=\ngithub.com/google/rpmpack v0.7.1/go.mod h1:h1JL16sUTWCLI/c39ox1rDaTBo3BXUQGjczVJyK4toU=\ngithub.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510 h1:El6M4kTTCOh6aBiKaUGG7oYTSPP8MxqL4YI3kZKwcP4=\ngithub.com/google/shlex v0.0.0-20191202100458-e7afc7fbc510/go.mod h1:pupxD2MaaD3pAXIBCelhxNneeOaAeabZDe5s4K6zSpQ=\ngithub.com/google/uuid v1.6.0 h1:NIvaJDMOsjHA8n1jAhLSgzrAzy1Hgr+hNrb57e+94F0=\ngithub.com/google/uuid v1.6.0/go.mod h1:TIyPZe4MgqvfeYDBFedMoGGpEw/LqOeaOT+nhxU+yHo=\ngithub.com/gopherjs/gopherjs v1.17.2 h1:fQnZVsXk8uxXIStYb0N4bGk7jeyTalG/wsZjQ25dO0g=\ngithub.com/gopherjs/gopherjs v1.17.2/go.mod h1:pRRIvn/QzFLrKfvEz3qUuEhtE/zLCWfreZ6J5gM2i+k=\ngithub.com/goreleaser/chglog v0.7.3 h1:eCKJrvsDgG+F1F2fhwM6qX+S5yMiZgsQ4VNTPFl9qEM=\ngithub.com/goreleaser/chglog v0.7.3/go.mod h1:HXPf4avc1kTD00a46LuTEH0i1dZctLq8Xs2BxUfROnY=\ngithub.com/goreleaser/fileglob v1.3.0 h1:/X6J7U8lbDpQtBvGcwwPS6OpzkNVlVEsFUVRx9+k+7I=\ngithub.com/goreleaser/fileglob v1.3.0/go.mod h1:Jx6BoXv3mbYkEzwm9THo7xbr5egkAraxkGorbJb4RxU=\ngithub.com/goreleaser/nfpm/v2 v2.43.0 h1:o5oureuZkhu55RK0M9WSN8JLW7hu6MymtMh7LypInlk=\ngithub.com/goreleaser/nfpm/v2 v2.43.0/go.mod h1:f//PE8PjNHjaPCbd7Jkok+aPKdLTrzM+fuIWg3PfVRg=\ngithub.com/grpc-ecosystem/go-grpc-middleware/providers/prometheus v1.1.0 h1:QGLs/O40yoNK9vmy4rhUGBVyMf1lISBGtXRpsu/Qu/o=\ngithub.com/grpc-ecosystem/go-grpc-middleware/providers/prometheus v1.1.0/go.mod h1:hM2alZsMUni80N33RBe6J0e423LB+odMj7d3EMP9l20=\ngithub.com/grpc-ecosystem/go-grpc-middleware/v2 v2.3.3 h1:B+8ClL/kCQkRiU82d9xajRPKYMrB7E0MbtzWVi1K4ns=\ngithub.com/grpc-ecosystem/go-grpc-middleware/v2 v2.3.3/go.mod h1:NbCUVmiS4foBGBHOYlCT25+YmGpJ32dZPi75pGEUpj4=\ngithub.com/grpc-ecosystem/grpc-gateway/v2 v2.26.3 h1:5ZPtiqj0JL5oKWmcsq4VMaAW5ukBEgSGXEN89zeH1Jo=\ngithub.com/grpc-ecosystem/grpc-gateway/v2 v2.26.3/go.mod h1:ndYquD05frm2vACXE1nsccT4oJzjhw2arTS2cpUD1PI=\ngithub.com/hashicorp/go-version v1.7.0 h1:5tqGy27NaOTB8yJKUZELlFAS/LTKJkrmONwQKeRZfjY=\ngithub.com/hashicorp/go-version v1.7.0/go.mod h1:fltr4n8CU8Ke44wwGCBoEymUuxUHl09ZGVZPK5anwXA=\ngithub.com/huandu/xstrings v1.5.0 h1:2ag3IFq9ZDANvthTwTiqSSZLjDc+BedvHPAp5tJy2TI=\ngithub.com/huandu/xstrings v1.5.0/go.mod h1:y5/lhBue+AyNmUVz9RLU9xbLR0o4KIIExikq4ovT0aE=\ngithub.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99 h1:BQSFePA1RWJOlocH6Fxy8MmwDt+yVQYULKfN0RoTN8A=\ngithub.com/jbenet/go-context v0.0.0-20150711004518-d14ea06fba99/go.mod h1:1lJo3i6rXxKeerYnT8Nvf0QmHCRC1n8sfWVwXF2Frvo=\ngithub.com/joho/godotenv v1.5.1 h1:7eLL/+HRGLY0ldzfGMeQkb7vMd0as4CfYvUVzLqw0N0=\ngithub.com/joho/godotenv v1.5.1/go.mod h1:f4LDr5Voq0i2e/R5DDNOoa2zzDfwtkZa6DnEwAbqwq4=\ngithub.com/jtolds/gls v4.20.0+incompatible h1:xdiiI2gbIgH/gLH7ADydsJ1uDOEzR8yvV7C0MuV77Wo=\ngithub.com/jtolds/gls v4.20.0+incompatible/go.mod h1:QJZ7F/aHp+rZTRtaJ1ow/lLfFfVYBRgL+9YlvaHOwJU=\ngithub.com/kevinburke/ssh_config v1.2.0 h1:x584FjTGwHzMwvHx18PXxbBVzfnxogHaAReU4gf13a4=\ngithub.com/kevinburke/ssh_config v1.2.0/go.mod h1:CT57kijsi8u/K/BOFA39wgDQJ9CxiF4nAY/ojJ6r6mM=\ngithub.com/kjk/lzma v0.0.0-20161016003348-3fd93898850d h1:RnWZeH8N8KXfbwMTex/KKMYMj0FJRCF6tQubUuQ02GM=\ngithub.com/kjk/lzma v0.0.0-20161016003348-3fd93898850d/go.mod h1:phT/jsRPBAEqjAibu1BurrabCBNTYiVI+zbmyCZJY6Q=\ngithub.com/klauspost/compress v1.18.0 h1:c/Cqfb0r+Yi+JtIEq73FWXVkRonBlf0CRNYc8Zttxdo=\ngithub.com/klauspost/compress v1.18.0/go.mod h1:2Pp+KzxcywXVXMr50+X0Q/Lsb43OQHYWRCY2AiWywWQ=\ngithub.com/klauspost/pgzip v1.2.6 h1:8RXeL5crjEUFnR2/Sn6GJNWtSQ3Dk8pq4CL3jvdDyjU=\ngithub.com/klauspost/pgzip v1.2.6/go.mod h1:Ch1tH69qFZu15pkjo5kYi6mth2Zzwzt50oCQKQE9RUs=\ngithub.com/kr/pretty v0.1.0/go.mod h1:dAy3ld7l9f0ibDNOQOHHMYYIIbhfbHSm3C4ZsoJORNo=\ngithub.com/kr/pretty v0.3.1 h1:flRD4NNwYAUpkphVc1HcthR4KEIFJ65n8Mw5qdRn3LE=\ngithub.com/kr/pretty v0.3.1/go.mod h1:hoEshYVHaxMs3cyo3Yncou5ZscifuDolrwPKZanG3xk=\ngithub.com/kr/pty v1.1.1/go.mod h1:pFQYn66WHrOpPYNljwOMqo10TkYh1fy3cYio2l3bCsQ=\ngithub.com/kr/text v0.1.0/go.mod h1:4Jbv+DJW3UT/LiOwJeYQe1efqtUx/iVham/4vfdArNI=\ngithub.com/kr/text v0.2.0 h1:5Nx0Ya0ZqY2ygV366QzturHI13Jq95ApcVaJBhpS+AY=\ngithub.com/kr/text v0.2.0/go.mod h1:eLer722TekiGuMkidMxC/pM04lWEeraHUUmBw8l2grE=\ngithub.com/kylelemons/godebug v1.1.0 h1:RPNrshWIDI6G2gRW9EHilWtl7Z6Sb1BR0xunSBf0SNc=\ngithub.com/kylelemons/godebug v1.1.0/go.mod h1:9/0rRGxNHcop5bhtWyNeEfOS8JIWk580+fNqagV/RAw=\ngithub.com/lufia/plan9stats v0.0.0-20250317134145-8bc96cf8fc35 h1:PpXWgLPs+Fqr325bN2FD2ISlRRztXibcX6e8f5FR5Dc=\ngithub.com/lufia/plan9stats v0.0.0-20250317134145-8bc96cf8fc35/go.mod h1:autxFIvghDt3jPTLoqZ9OZ7s9qTGNAWmYCjVFWPX/zg=\ngithub.com/lum8rjack/go-ja4h v0.0.0-20250828030157-fa5266d50650 h1:hhx/Mo6+Hk0mAQS5MW311ON1VlSzp0D1cYhY27IcmnI=\ngithub.com/lum8rjack/go-ja4h v0.0.0-20250828030157-fa5266d50650/go.mod h1:bMqyXOakqQIdx82d4vcnk5TIZLptZ2gLqju9xmPrWYA=\ngithub.com/magiconair/properties v1.8.10 h1:s31yESBquKXCV9a/ScB3ESkOjUYYv+X0rg8SYxI99mE=\ngithub.com/magiconair/properties v1.8.10/go.mod h1:Dhd985XPs7jluiymwWYZ0G4Z61jb3vdS329zhj2hYo0=\ngithub.com/matryer/is v1.4.0 h1:sosSmIWwkYITGrxZ25ULNDeKiMNzFSr4V/eqBQP0PeE=\ngithub.com/matryer/is v1.4.0/go.mod h1:8I/i5uYgLzgsgEloJE1U6xx5HkBQpAZvepWuujKwMRU=\ngithub.com/mattn/go-colorable v0.1.14 h1:9A9LHSqF/7dyVVX6g0U9cwm9pG3kP9gSzcuIPHPsaIE=\ngithub.com/mattn/go-colorable v0.1.14/go.mod h1:6LmQG8QLFO4G5z1gPvYEzlUgJ2wF+stgPZH1UqBm1s8=\ngithub.com/mattn/go-isatty v0.0.20 h1:xfD0iDuEKnDkl03q4limB+vH+GxLEtL/jb4xVJSWWEY=\ngithub.com/mattn/go-isatty v0.0.20/go.mod h1:W+V8PltTTMOvKvAeJH7IuucS94S2C6jfK/D7dTCTo3Y=\ngithub.com/mitchellh/copystructure v1.2.0 h1:vpKXTN4ewci03Vljg/q9QvCGUDttBOGBIa15WveJJGw=\ngithub.com/mitchellh/copystructure v1.2.0/go.mod h1:qLl+cE2AmVv+CoeAwDPye/v+N2HKCj9FbZEVFJRxO9s=\ngithub.com/mitchellh/go-ps v1.0.0 h1:i6ampVEEF4wQFF+bkYfwYgY+F/uYJDktmvLPf7qIgjc=\ngithub.com/mitchellh/go-ps v1.0.0/go.mod h1:J4lOc8z8yJs6vUwklHw2XEIiT4z4C40KtWVN3nvg8Pg=\ngithub.com/mitchellh/reflectwalk v1.0.2 h1:G2LzWKi524PWgd3mLHV8Y5k7s6XUvT0Gef6zxSIeXaQ=\ngithub.com/mitchellh/reflectwalk v1.0.2/go.mod h1:mSTlrgnPZtwu0c4WaC2kGObEpuNDbx0jmZXqmk4esnw=\ngithub.com/moby/docker-image-spec v1.3.1 h1:jMKff3w6PgbfSa69GfNg+zN/XLhfXJGnEx3Nl2EsFP0=\ngithub.com/moby/docker-image-spec v1.3.1/go.mod h1:eKmb5VW8vQEh/BAr2yvVNvuiJuY6UIocYsFu/DxxRpo=\ngithub.com/moby/go-archive v0.1.0 h1:Kk/5rdW/g+H8NHdJW2gsXyZ7UnzvJNOy6VKJqueWdcQ=\ngithub.com/moby/go-archive v0.1.0/go.mod h1:G9B+YoujNohJmrIYFBpSd54GTUB4lt9S+xVQvsJyFuo=\ngithub.com/moby/patternmatcher v0.6.0 h1:GmP9lR19aU5GqSSFko+5pRqHi+Ohk1O69aFiKkVGiPk=\ngithub.com/moby/patternmatcher v0.6.0/go.mod h1:hDPoyOpDY7OrrMDLaYoY3hf52gNCR/YOUYxkhApJIxc=\ngithub.com/moby/sys/atomicwriter v0.1.0 h1:kw5D/EqkBwsBFi0ss9v1VG3wIkVhzGvLklJ+w3A14Sw=\ngithub.com/moby/sys/atomicwriter v0.1.0/go.mod h1:Ul8oqv2ZMNHOceF643P6FKPXeCmYtlQMvpizfsSoaWs=\ngithub.com/moby/sys/sequential v0.6.0 h1:qrx7XFUd/5DxtqcoH1h438hF5TmOvzC/lspjy7zgvCU=\ngithub.com/moby/sys/sequential v0.6.0/go.mod h1:uyv8EUTrca5PnDsdMGXhZe6CCe8U/UiTWd+lL+7b/Ko=\ngithub.com/moby/sys/user v0.4.0 h1:jhcMKit7SA80hivmFJcbB1vqmw//wU61Zdui2eQXuMs=\ngithub.com/moby/sys/user v0.4.0/go.mod h1:bG+tYYYJgaMtRKgEmuueC0hJEAZWwtIbZTB+85uoHjs=\ngithub.com/moby/sys/userns v0.1.0 h1:tVLXkFOxVu9A64/yh59slHVv9ahO9UIev4JZusOLG/g=\ngithub.com/moby/sys/userns v0.1.0/go.mod h1:IHUYgu/kao6N8YZlp9Cf444ySSvCmDlmzUcYfDHOl28=\ngithub.com/moby/term v0.5.2 h1:6qk3FJAFDs6i/q3W/pQ97SX192qKfZgGjCQqfCJkgzQ=\ngithub.com/moby/term v0.5.2/go.mod h1:d3djjFCrjnB+fl8NJux+EJzu0msscUP+f8it8hPkFLc=\ngithub.com/morikuni/aec v1.0.0 h1:nP9CBfwrvYnBRgY6qfDQkygYDmYwOilePFkwzv4dU8A=\ngithub.com/morikuni/aec v1.0.0/go.mod h1:BbKIizmSmc5MMPqRYbxO4ZU0S0+P200+tUnFx7PXmsc=\ngithub.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822 h1:C3w9PqII01/Oq1c1nUAm88MOHcQC9l5mIlSMApZMrHA=\ngithub.com/munnerz/goautoneg v0.0.0-20191010083416-a7dc8b61c822/go.mod h1:+n7T8mK8HuQTcFwEeznm/DIxMOiR9yIdICNftLE1DvQ=\ngithub.com/natefinch/atomic v1.0.1 h1:ZPYKxkqQOx3KZ+RsbnP/YsgvxWQPGxjC0oBt2AhwV0A=\ngithub.com/natefinch/atomic v1.0.1/go.mod h1:N/D/ELrljoqDyT3rZrsUmtsuzvHkeB/wWjHV22AZRbM=\ngithub.com/nicksnyder/go-i18n/v2 v2.6.0 h1:C/m2NNWNiTB6SK4Ao8df5EWm3JETSTIGNXBpMJTxzxQ=\ngithub.com/nicksnyder/go-i18n/v2 v2.6.0/go.mod h1:88sRqr0C6OPyJn0/KRNaEz1uWorjxIKP7rUUcvycecE=\ngithub.com/nikandfor/spintax v0.0.0-20181023094358-fc346b245bb3 h1:foZ9X1bz2KmW7b8Yx5V0LAQKhTazdllv5rnGUe6iGTY=\ngithub.com/nikandfor/spintax v0.0.0-20181023094358-fc346b245bb3/go.mod h1:wwDYKfVF3WHdY0rugsAZoIpyQjDA3bn9wEzo/QXPx1Y=\ngithub.com/onsi/gomega v1.35.1 h1:Cwbd75ZBPxFSuZ6T+rN/WCb/gOc6YgFBXLlZLhC7Ds4=\ngithub.com/onsi/gomega v1.35.1/go.mod h1:PvZbdDc8J6XJEpDK4HCuRBm8a6Fzp9/DmhC9C7yFlog=\ngithub.com/opencontainers/go-digest v1.0.0 h1:apOUWs51W5PlhuyGyz9FCeeBIOUDA/6nW8Oi/yOhh5U=\ngithub.com/opencontainers/go-digest v1.0.0/go.mod h1:0JzlMkj0TRzQZfJkVvzbP0HBR3IKzErnv2BNG4W4MAM=\ngithub.com/opencontainers/image-spec v1.1.1 h1:y0fUlFfIZhPF1W537XOLg0/fcx6zcHCJwooC2xJA040=\ngithub.com/opencontainers/image-spec v1.1.1/go.mod h1:qpqAh3Dmcf36wStyyWU+kCeDgrGnAve2nCC8+7h8Q0M=\ngithub.com/pjbgf/sha1cd v0.4.0 h1:NXzbL1RvjTUi6kgYZCX3fPwwl27Q1LJndxtUDVfJGRY=\ngithub.com/pjbgf/sha1cd v0.4.0/go.mod h1:zQWigSxVmsHEZow5qaLtPYxpcKMMQpa09ixqBxuCS6A=\ngithub.com/pkg/errors v0.9.1 h1:FEBLx1zS214owpjy7qsBeixbURkuhQAwrK5UwLGTwt4=\ngithub.com/pkg/errors v0.9.1/go.mod h1:bwawxfHBFNV+L2hUp1rHADufV3IMtnDRdf1r5NINEl0=\ngithub.com/playwright-community/playwright-go v0.5200.1 h1:Sm2oOuhqt0M5Y4kUi/Qh9w4cyyi3ZIWTBeGKImc2UVo=\ngithub.com/playwright-community/playwright-go v0.5200.1/go.mod h1:UnnyQZaqUOO5ywAZu60+N4EiWReUqX1MQBBA3Oofvf8=\ngithub.com/pmezard/go-difflib v1.0.0/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=\ngithub.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2 h1:Jamvg5psRIccs7FGNTlIRMkT8wgtp5eCXdBlqhYGL6U=\ngithub.com/pmezard/go-difflib v1.0.1-0.20181226105442-5d4384ee4fb2/go.mod h1:iKH77koFhYxTK1pcRnkKkqfTogsbg7gZNVY4sRDYZ/4=\ngithub.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55 h1:o4JXh1EVt9k/+g42oCprj/FisM4qX9L3sZB3upGN2ZU=\ngithub.com/power-devops/perfstat v0.0.0-20240221224432-82ca36839d55/go.mod h1:OmDBASR4679mdNQnz2pUhc2G8CO2JrUAVFDRBDP/hJE=\ngithub.com/prometheus/client_golang v1.23.2 h1:Je96obch5RDVy3FDMndoUsjAhG5Edi49h0RJWRi/o0o=\ngithub.com/prometheus/client_golang v1.23.2/go.mod h1:Tb1a6LWHB3/SPIzCoaDXI4I8UHKeFTEQ1YCr+0Gyqmg=\ngithub.com/prometheus/client_model v0.6.2 h1:oBsgwpGs7iVziMvrGhE53c/GrLUsZdHnqNwqPLxwZyk=\ngithub.com/prometheus/client_model v0.6.2/go.mod h1:y3m2F6Gdpfy6Ut/GBsUqTWZqCUvMVzSfMLjcu6wAwpE=\ngithub.com/prometheus/common v0.67.4 h1:yR3NqWO1/UyO1w2PhUvXlGQs/PtFmoveVO0KZ4+Lvsc=\ngithub.com/prometheus/common v0.67.4/go.mod h1:gP0fq6YjjNCLssJCQp0yk4M8W6ikLURwkdd/YKtTbyI=\ngithub.com/prometheus/procfs v0.19.2 h1:zUMhqEW66Ex7OXIiDkll3tl9a1ZdilUOd/F6ZXw4Vws=\ngithub.com/prometheus/procfs v0.19.2/go.mod h1:M0aotyiemPhBCM0z5w87kL22CxfcH05ZpYlu+b4J7mw=\ngithub.com/redis/go-redis/v9 v9.17.2 h1:P2EGsA4qVIM3Pp+aPocCJ7DguDHhqrXNhVcEp4ViluI=\ngithub.com/redis/go-redis/v9 v9.17.2/go.mod h1:u410H11HMLoB+TP67dz8rL9s6QW2j76l0//kSOd3370=\ngithub.com/rogpeppe/go-internal v1.14.1 h1:UQB4HGPB6osV0SQTLymcB4TgvyWu6ZyliaW0tI/otEQ=\ngithub.com/rogpeppe/go-internal v1.14.1/go.mod h1:MaRKkUm5W0goXpeCfT7UZI6fk/L7L7so1lCWt35ZSgc=\ngithub.com/russross/blackfriday/v2 v2.1.0 h1:JIOH55/0cWyOuilr9/qlrm0BSXldqnqwMsf35Ld67mk=\ngithub.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=\ngithub.com/sassoftware/go-rpmutils v0.4.0 h1:ojND82NYBxgwrV+mX1CWsd5QJvvEZTKddtCdFLPWhpg=\ngithub.com/sassoftware/go-rpmutils v0.4.0/go.mod h1:3goNWi7PGAT3/dlql2lv3+MSN5jNYPjT5mVcQcIsYzI=\ngithub.com/sebest/xff v0.0.0-20210106013422-671bd2870b3a h1:iLcLb5Fwwz7g/DLK89F+uQBDeAhHhwdzB5fSlVdhGcM=\ngithub.com/sebest/xff v0.0.0-20210106013422-671bd2870b3a/go.mod h1:wozgYq9WEBQBaIJe4YZ0qTSFAMxmcwBhQH0fO0R34Z0=\ngithub.com/sergi/go-diff v1.4.0 h1:n/SP9D5ad1fORl+llWyN+D6qoUETXNZARKjyY2/KVCw=\ngithub.com/sergi/go-diff v1.4.0/go.mod h1:A0bzQcvG0E7Rwjx0REVgAGH58e96+X0MeOfepqsbeW4=\ngithub.com/shirou/gopsutil/v4 v4.25.11 h1:X53gB7muL9Gnwwo2evPSE+SfOrltMoR6V3xJAXZILTY=\ngithub.com/shirou/gopsutil/v4 v4.25.11/go.mod h1:EivAfP5x2EhLp2ovdpKSozecVXn1TmuG7SMzs/Wh4PU=\ngithub.com/shopspring/decimal v1.4.0 h1:bxl37RwXBklmTi0C79JfXCEBD1cqqHt0bbgBAGFp81k=\ngithub.com/shopspring/decimal v1.4.0/go.mod h1:gawqmDU56v4yIKSwfBSFip1HdCCXN8/+DMd9qYNcwME=\ngithub.com/sirupsen/logrus v1.7.0/go.mod h1:yWOB1SBYBC5VeMP7gHvWumXLIWorT60ONWic61uBYv0=\ngithub.com/sirupsen/logrus v1.9.3 h1:dueUQJ1C2q9oE3F7wvmSGAaVtTmUizReu6fjN8uqzbQ=\ngithub.com/sirupsen/logrus v1.9.3/go.mod h1:naHLuLoDiP4jHNo9R0sCBMtWGeIprob74mVsIT4qYEQ=\ngithub.com/skeema/knownhosts v1.3.1 h1:X2osQ+RAjK76shCbvhHHHVl3ZlgDm8apHEHFqRjnBY8=\ngithub.com/skeema/knownhosts v1.3.1/go.mod h1:r7KTdC8l4uxWRyK2TpQZ/1o5HaSzh06ePQNxPwTcfiY=\ngithub.com/smarty/assertions v1.15.0 h1:cR//PqUBUiQRakZWqBiFFQ9wb8emQGDb0HeGdqGByCY=\ngithub.com/smarty/assertions v1.15.0/go.mod h1:yABtdzeQs6l1brC900WlRNwj6ZR55d7B+E8C6HtKdec=\ngithub.com/smartystreets/goconvey v1.8.1 h1:qGjIddxOk4grTu9JPOU31tVfq3cNdBlNa5sSznIX1xY=\ngithub.com/smartystreets/goconvey v1.8.1/go.mod h1:+/u4qLyY6x1jReYOp7GOM2FSt8aP9CzCZL03bI28W60=\ngithub.com/spf13/afero v1.14.0 h1:9tH6MapGnn/j0eb0yIXiLjERO8RB6xIVZRDCX7PtqWA=\ngithub.com/spf13/afero v1.14.0/go.mod h1:acJQ8t0ohCGuMN3O+Pv0V0hgMxNYDlvdk+VTfyZmbYo=\ngithub.com/spf13/cast v1.9.2 h1:SsGfm7M8QOFtEzumm7UZrZdLLquNdzFYfIbEXntcFbE=\ngithub.com/spf13/cast v1.9.2/go.mod h1:jNfB8QC9IA6ZuY2ZjDp0KtFO2LZZlg4S/7bzP6qqeHo=\ngithub.com/stoewer/go-strcase v1.3.1 h1:iS0MdW+kVTxgMoE1LAZyMiYJFKlOzLooE4MxjirtkAs=\ngithub.com/stoewer/go-strcase v1.3.1/go.mod h1:fAH5hQ5pehh+j3nZfvwdk2RgEgQjAoM8wodgtPmh1xo=\ngithub.com/stretchr/objx v0.1.0/go.mod h1:HFkY916IF+rwdDfMAkV7OtwuqBVzrE8GR6GFx+wExME=\ngithub.com/stretchr/objx v0.4.0/go.mod h1:YvHI0jy2hoMjB+UWwv71VJQ9isScKT/TqJzVSSt89Yw=\ngithub.com/stretchr/objx v0.5.0/go.mod h1:Yh+to48EsGEfYuaHDzXPcE3xhTkx73EhmCGUpEOglKo=\ngithub.com/stretchr/objx v0.5.2 h1:xuMeJ0Sdp5ZMRXx/aWO6RZxdr3beISkG5/G/aIRr3pY=\ngithub.com/stretchr/objx v0.5.2/go.mod h1:FRsXN1f5AsAjCGJKqEizvkpNtU+EGNCLh3NxZ/8L+MA=\ngithub.com/stretchr/testify v1.2.2/go.mod h1:a8OnRcib4nhh0OaRAV+Yts87kKdq0PP7pXfy6kDkUVs=\ngithub.com/stretchr/testify v1.4.0/go.mod h1:j7eGeouHqKxXV5pUuKE4zz7dFj8WfuZ+81PSLYec5m4=\ngithub.com/stretchr/testify v1.7.0/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=\ngithub.com/stretchr/testify v1.7.1/go.mod h1:6Fq8oRcR53rry900zMqJjRRixrwX3KX962/h/Wwjteg=\ngithub.com/stretchr/testify v1.8.0/go.mod h1:yNjHg4UonilssWZ8iaSj1OCr/vHnekPRkoO+kdMU+MU=\ngithub.com/stretchr/testify v1.8.1/go.mod h1:w2LPCIKwWwSfY2zedu0+kehJoqGctiVI29o6fzry7u4=\ngithub.com/stretchr/testify v1.11.1 h1:7s2iGBzp5EwR7/aIZr8ao5+dra3wiQyKjjFuvgVKu7U=\ngithub.com/stretchr/testify v1.11.1/go.mod h1:wZwfW3scLgRK+23gO65QZefKpKQRnfz6sD981Nm4B6U=\ngithub.com/suzuki-shunsuke/logrus-error v0.1.4 h1:nWo98uba1fANHdZ9Y5pJ2RKs/PpVjrLzRp5m+mRb9KE=\ngithub.com/suzuki-shunsuke/logrus-error v0.1.4/go.mod h1:WsVvvw6SKSt08/fB2qbnsKIMJA4K1MYCUprqsBJbMiM=\ngithub.com/suzuki-shunsuke/pinact v1.6.0 h1:2QvSzREOquwLwKXhF9Hj0AInE/Rl63SZz9dKkHFC6so=\ngithub.com/suzuki-shunsuke/pinact v1.6.0/go.mod h1:FDUMck0mmL0mcnNZ23Vjh/aOR5cIdZhF1IIpGksT4dQ=\ngithub.com/suzuki-shunsuke/urfave-cli-help-all v0.0.4 h1:YGHgrVjGTYHY98II6zijXUHP+OyvrzSCvd8m9iUcaK8=\ngithub.com/suzuki-shunsuke/urfave-cli-help-all v0.0.4/go.mod h1:sSi6xaUaHfaqu32ECLeyE7NTMv+ZM5dW0JikhllaalY=\ngithub.com/testcontainers/testcontainers-go v0.40.0 h1:pSdJYLOVgLE8YdUY2FHQ1Fxu+aMnb6JfVz1mxk7OeMU=\ngithub.com/testcontainers/testcontainers-go v0.40.0/go.mod h1:FSXV5KQtX2HAMlm7U3APNyLkkap35zNLxukw9oBi/MY=\ngithub.com/tklauser/go-sysconf v0.3.16 h1:frioLaCQSsF5Cy1jgRBrzr6t502KIIwQ0MArYICU0nA=\ngithub.com/tklauser/go-sysconf v0.3.16/go.mod h1:/qNL9xxDhc7tx3HSRsLWNnuzbVfh3e7gh/BmM179nYI=\ngithub.com/tklauser/numcpus v0.11.0 h1:nSTwhKH5e1dMNsCdVBukSZrURJRoHbSEQjdEbY+9RXw=\ngithub.com/tklauser/numcpus v0.11.0/go.mod h1:z+LwcLq54uWZTX0u/bGobaV34u6V7KNlTZejzM6/3MQ=\ngithub.com/ulikunitz/xz v0.5.14 h1:uv/0Bq533iFdnMHZdRBTOlaNMdb1+ZxXIlHDZHIHcvg=\ngithub.com/ulikunitz/xz v0.5.14/go.mod h1:nbz6k7qbPmH4IRqmfOplQw/tblSgqTqBwxkY0oWt/14=\ngithub.com/urfave/cli/v2 v2.27.7 h1:bH59vdhbjLv3LAvIu6gd0usJHgoTTPhCFib8qqOwXYU=\ngithub.com/urfave/cli/v2 v2.27.7/go.mod h1:CyNAG/xg+iAOg0N4MPGZqVmv2rCoP267496AOXUZjA4=\ngithub.com/xanzy/ssh-agent v0.3.3 h1:+/15pJfg/RsTxqYcX6fHqOXZwwMP+2VyYWJeWM2qQFM=\ngithub.com/xanzy/ssh-agent v0.3.3/go.mod h1:6dzNDKs0J9rVPHPhaGCukekBHKqfl+L3KghI1Bc68Uw=\ngithub.com/xi2/xz v0.0.0-20171230120015-48954b6210f8 h1:nIPpBwaJSVYIxUFsDv3M8ofmx9yWTog9BfvIu0q41lo=\ngithub.com/xi2/xz v0.0.0-20171230120015-48954b6210f8/go.mod h1:HUYIGzjTL3rfEspMxjDjgmT5uz5wzYJKVo23qUhYTos=\ngithub.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342 h1:FnBeRrxr7OU4VvAzt5X7s6266i6cSVkkFPS0TuXWbIg=\ngithub.com/xrash/smetrics v0.0.0-20250705151800-55b8f293f342/go.mod h1:Ohn+xnUBiLI6FVj/9LpzZWtj1/D6lUovWYBkxHVV3aM=\ngithub.com/xyproto/randomstring v1.0.5 h1:YtlWPoRdgMu3NZtP45drfy1GKoojuR7hmRcnhZqKjWU=\ngithub.com/xyproto/randomstring v1.0.5/go.mod h1:rgmS5DeNXLivK7YprL0pY+lTuhNQW3iGxZ18UQApw/E=\ngithub.com/yuin/goldmark v1.4.13/go.mod h1:6yULJ656Px+3vBD8DxQVa3kxgyrAnzto9xy5taEt/CY=\ngithub.com/yusufpapurcu/wmi v1.2.4 h1:zFUKzehAFReQwLys1b/iSMl+JQGSCSjtVqQn9bBrPo0=\ngithub.com/yusufpapurcu/wmi v1.2.4/go.mod h1:SBZ9tNy3G9/m5Oi98Zks0QjeHVDvuK0qfxQmPyzfmi0=\ngitlab.com/digitalxero/go-conventional-commit v1.0.7 h1:8/dO6WWG+98PMhlZowt/YjuiKhqhGlOCwlIV8SqqGh8=\ngitlab.com/digitalxero/go-conventional-commit v1.0.7/go.mod h1:05Xc2BFsSyC5tKhK0y+P3bs0AwUtNuTp+mTpbCU/DZ0=\ngo.etcd.io/bbolt v1.4.3 h1:dEadXpI6G79deX5prL3QRNP6JB8UxVkqo4UPnHaNXJo=\ngo.etcd.io/bbolt v1.4.3/go.mod h1:tKQlpPaYCVFctUIgFKFnAlvbmB3tpy1vkTnDWohtc0E=\ngo.opentelemetry.io/auto/sdk v1.2.1 h1:jXsnJ4Lmnqd11kwkBV2LgLoFMZKizbCi5fNZ/ipaZ64=\ngo.opentelemetry.io/auto/sdk v1.2.1/go.mod h1:KRTj+aOaElaLi+wW1kO/DZRXwkF4C5xPbEe3ZiIhN7Y=\ngo.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.62.0 h1:Hf9xI/XLML9ElpiHVDNwvqI0hIFlzV8dgIr35kV1kRU=\ngo.opentelemetry.io/contrib/instrumentation/net/http/otelhttp v0.62.0/go.mod h1:NfchwuyNoMcZ5MLHwPrODwUF1HWCXWrL31s8gSAdIKY=\ngo.opentelemetry.io/otel v1.38.0 h1:RkfdswUDRimDg0m2Az18RKOsnI8UDzppJAtj01/Ymk8=\ngo.opentelemetry.io/otel v1.38.0/go.mod h1:zcmtmQ1+YmQM9wrNsTGV/q/uyusom3P8RxwExxkZhjM=\ngo.opentelemetry.io/otel/exporters/otlp/otlptrace v1.37.0 h1:Ahq7pZmv87yiyn3jeFz/LekZmPLLdKejuO3NcK9MssM=\ngo.opentelemetry.io/otel/exporters/otlp/otlptrace v1.37.0/go.mod h1:MJTqhM0im3mRLw1i8uGHnCvUEeS7VwRyxlLC78PA18M=\ngo.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.19.0 h1:IeMeyr1aBvBiPVYihXIaeIZba6b8E1bYp7lbdxK8CQg=\ngo.opentelemetry.io/otel/exporters/otlp/otlptrace/otlptracehttp v1.19.0/go.mod h1:oVdCUtjq9MK9BlS7TtucsQwUcXcymNiEDjgDD2jMtZU=\ngo.opentelemetry.io/otel/metric v1.38.0 h1:Kl6lzIYGAh5M159u9NgiRkmoMKjvbsKtYRwgfrA6WpA=\ngo.opentelemetry.io/otel/metric v1.38.0/go.mod h1:kB5n/QoRM8YwmUahxvI3bO34eVtQf2i4utNVLr9gEmI=\ngo.opentelemetry.io/otel/sdk v1.38.0 h1:l48sr5YbNf2hpCUj/FoGhW9yDkl+Ma+LrVl8qaM5b+E=\ngo.opentelemetry.io/otel/sdk v1.38.0/go.mod h1:ghmNdGlVemJI3+ZB5iDEuk4bWA3GkTpW+DOoZMYBVVg=\ngo.opentelemetry.io/otel/sdk/metric v1.38.0 h1:aSH66iL0aZqo//xXzQLYozmWrXxyFkBJ6qT5wthqPoM=\ngo.opentelemetry.io/otel/sdk/metric v1.38.0/go.mod h1:dg9PBnW9XdQ1Hd6ZnRz689CbtrUp0wMMs9iPcgT9EZA=\ngo.opentelemetry.io/otel/trace v1.38.0 h1:Fxk5bKrDZJUH+AMyyIXGcFAPah0oRcT+LuNtJrmcNLE=\ngo.opentelemetry.io/otel/trace v1.38.0/go.mod h1:j1P9ivuFsTceSWe1oY+EeW3sc+Pp42sO++GHkg4wwhs=\ngo.opentelemetry.io/proto/otlp v1.7.0 h1:jX1VolD6nHuFzOYso2E73H85i92Mv8JQYk0K9vz09os=\ngo.opentelemetry.io/proto/otlp v1.7.0/go.mod h1:fSKjH6YJ7HDlwzltzyMj036AJ3ejJLCgCSHGj4efDDo=\ngo.uber.org/goleak v1.3.0 h1:2K3zAYmnTNqV73imy9J1T3WC+gmCePx2hEGkimedGto=\ngo.uber.org/goleak v1.3.0/go.mod h1:CoHD4mav9JJNrW/WLlf7HGZPjdw8EucARQHekz1X6bE=\ngo.yaml.in/yaml/v2 v2.4.3 h1:6gvOSjQoTB3vt1l+CU+tSyi/HOjfOjRLJ4YwYZGwRO0=\ngo.yaml.in/yaml/v2 v2.4.3/go.mod h1:zSxWcmIDjOzPXpjlTTbAsKokqkDNAVtZO0WOMiT90s8=\ngo.yaml.in/yaml/v3 v3.0.4 h1:tfq32ie2Jv2UxXFdLJdh3jXuOzWiL1fo0bu/FbuKpbc=\ngo.yaml.in/yaml/v3 v3.0.4/go.mod h1:DhzuOOF2ATzADvBadXxruRBLzYTpT36CKvDb3+aBEFg=\ngolang.org/x/crypto v0.0.0-20190308221718-c2843e01d9a2/go.mod h1:djNgcEr1/C05ACkg1iLfiJU5Ep61QUkGW8qpdssI0+w=\ngolang.org/x/crypto v0.0.0-20210921155107-089bfa567519/go.mod h1:GvvjBRRGRdwPK5ydBHafDWAxML/pGHZbMvKqRZ5+Abc=\ngolang.org/x/crypto v0.0.0-20220622213112-05595931fe9d/go.mod h1:IxCIyHEi3zRg3s0A5j5BB6A9Jmi73HwBIUl50j+osU4=\ngolang.org/x/crypto v0.19.0/go.mod h1:Iy9bg/ha4yyC70EfRS8jz+B6ybOBKMaSxLj6P6oBDfU=\ngolang.org/x/crypto v0.46.0 h1:cKRW/pmt1pKAfetfu+RCEvjvZkA9RimPbh7bhFjGVBU=\ngolang.org/x/crypto v0.46.0/go.mod h1:Evb/oLKmMraqjZ2iQTwDwvCtJkczlDuTmdJXoZVzqU0=\ngolang.org/x/exp v0.0.0-20251209150349-8475f28825e9 h1:MDfG8Cvcqlt9XXrmEiD4epKn7VJHZO84hejP9Jmp0MM=\ngolang.org/x/exp v0.0.0-20251209150349-8475f28825e9/go.mod h1:EPRbTFwzwjXj9NpYyyrvenVh9Y+GFeEvMNh7Xuz7xgU=\ngolang.org/x/exp/typeparams v0.0.0-20250718183923-645b1fa84792 h1:54/e+WfmhvjR2Zuz8Q7dzLGxIBM+s5WZpvo1QfVDGB8=\ngolang.org/x/exp/typeparams v0.0.0-20250718183923-645b1fa84792/go.mod h1:LKZHyeOpPuZcMgxeHjJp4p5yvxrCX1xDvH10zYHhjjQ=\ngolang.org/x/mod v0.6.0-dev.0.20220419223038-86c51ed26bb4/go.mod h1:jJ57K6gSWd91VN4djpZkiMVwK6gcyfeH4XE8wZrZaV4=\ngolang.org/x/mod v0.8.0/go.mod h1:iBbtSCu2XBx23ZKBPSOrRkjjQPZFPuis4dIYUhu/chs=\ngolang.org/x/mod v0.31.0 h1:HaW9xtz0+kOcWKwli0ZXy79Ix+UW/vOfmWI5QVd2tgI=\ngolang.org/x/mod v0.31.0/go.mod h1:43JraMp9cGx1Rx3AqioxrbrhNsLl2l/iNAvuBkrezpg=\ngolang.org/x/net v0.0.0-20190620200207-3b0461eec859/go.mod h1:z5CRVTTTmAJ677TzLLGU+0bjPO0LkuOLi4/5GtJWs/s=\ngolang.org/x/net v0.0.0-20210226172049-e18ecbb05110/go.mod h1:m0MpNAwzfU5UDzcl9v0D8zg8gWTRqZa9RBIspLL5mdg=\ngolang.org/x/net v0.0.0-20211112202133-69e39bad7dc2/go.mod h1:9nx3DQGgdP8bBQD5qxJ1jj9UTztislL4KSBs9R2vV5Y=\ngolang.org/x/net v0.0.0-20220722155237-a158d28d115b/go.mod h1:XRhObCWvk6IyKnWLug+ECip1KBveYUHfp+8e9klMJ9c=\ngolang.org/x/net v0.6.0/go.mod h1:2Tu9+aMcznHK/AK1HMvgo6xiTLG5rD5rZLDS+rp2Bjs=\ngolang.org/x/net v0.10.0/go.mod h1:0qNGK6F8kojg2nk9dLZ2mShWaEBan6FAoqfSigmmuDg=\ngolang.org/x/net v0.48.0 h1:zyQRTTrjc33Lhh0fBgT/H3oZq9WuvRR5gPC70xpDiQU=\ngolang.org/x/net v0.48.0/go.mod h1:+ndRgGjkh8FGtu1w1FGbEC31if4VrNVMuKTgcAAnQRY=\ngolang.org/x/oauth2 v0.32.0 h1:jsCblLleRMDrxMN29H3z/k1KliIvpLgCkE6R8FXXNgY=\ngolang.org/x/oauth2 v0.32.0/go.mod h1:lzm5WQJQwKZ3nwavOZ3IS5Aulzxi68dUSgRHujetwEA=\ngolang.org/x/sync v0.0.0-20190423024810-112230192c58/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=\ngolang.org/x/sync v0.0.0-20220722155255-886fb9371eb4/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=\ngolang.org/x/sync v0.1.0/go.mod h1:RxMgew5VJxzue5/jJTE5uejpjVlOe/izrB70Jof72aM=\ngolang.org/x/sync v0.19.0 h1:vV+1eWNmZ5geRlYjzm2adRgW2/mcpevXNg50YZtPCE4=\ngolang.org/x/sync v0.19.0/go.mod h1:9KTHXmSnoGruLpwFjVSX0lNNA75CykiMECbovNTZqGI=\ngolang.org/x/sys v0.0.0-20190215142949-d0b11bdaac8a/go.mod h1:STP8DvDyc/dI5b8T5hshtkjS+E42TnysNCUPdjciGhY=\ngolang.org/x/sys v0.0.0-20190916202348-b4ddaad3f8a3/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20191026070338-33540a1f6037/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20201119102817-f84b799fce68/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20201204225414-ed752295db88/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20210124154548-22da62e12c0c/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20210423082822-04245dca01da/go.mod h1:h1NjWce9XRLGQEsW7wpKNCjG9DtNlClVuFLEZdDNbEs=\ngolang.org/x/sys v0.0.0-20210615035016-665e8c7367d1/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.0.0-20210616094352-59db8d763f22/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.0.0-20220520151302-bc2c85ada10a/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.0.0-20220615213510-4f61da869c0c/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.0.0-20220715151400-c0bba94af5f8/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.0.0-20220722155257-8c9f86f7a55f/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.1.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.5.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.6.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.8.0/go.mod h1:oPkhp1MJrh7nUepCBck5+mAzfO9JrbApNNgaTdGDITg=\ngolang.org/x/sys v0.17.0/go.mod h1:/VUhepiaJMQUp4+oa/7Zr1D23ma6VTLIYjOOTFZPUcA=\ngolang.org/x/sys v0.39.0 h1:CvCKL8MeisomCi6qNZ+wbb0DN9E5AATixKsvNtMoMFk=\ngolang.org/x/sys v0.39.0/go.mod h1:OgkHotnGiDImocRcuBABYBEXf8A9a87e/uXjp9XT3ks=\ngolang.org/x/telemetry v0.0.0-20251203150158-8fff8a5912fc h1:bH6xUXay0AIFMElXG2rQ4uiE+7ncwtiOdPfYK1NK2XA=\ngolang.org/x/telemetry v0.0.0-20251203150158-8fff8a5912fc/go.mod h1:hKdjCMrbv9skySur+Nek8Hd0uJ0GuxJIoIX2payrIdQ=\ngolang.org/x/term v0.0.0-20201126162022-7de9c90e9dd1/go.mod h1:bj7SfCRtBDWHUb9snDiAeCFNEtKQo2Wmx5Cou7ajbmo=\ngolang.org/x/term v0.0.0-20210927222741-03fcf44c2211/go.mod h1:jbD1KX2456YbFQfuXm/mYQcufACuNUgVhRMnK/tPxf8=\ngolang.org/x/term v0.5.0/go.mod h1:jMB1sMXY+tzblOD4FWmEbocvup2/aLOaQEp7JmGp78k=\ngolang.org/x/term v0.8.0/go.mod h1:xPskH00ivmX89bAKVGSKKtLOWNx2+17Eiy94tnKShWo=\ngolang.org/x/term v0.17.0/go.mod h1:lLRBjIVuehSbZlaOtGMbcMncT+aqLLLmKrsjNrUguwk=\ngolang.org/x/term v0.38.0 h1:PQ5pkm/rLO6HnxFR7N2lJHOZX6Kez5Y1gDSJla6jo7Q=\ngolang.org/x/term v0.38.0/go.mod h1:bSEAKrOT1W+VSu9TSCMtoGEOUcKxOKgl3LE5QEF/xVg=\ngolang.org/x/text v0.3.0/go.mod h1:NqM8EUOU14njkJ3fqMW+pc6Ldnwhi/IjpwHt7yyuwOQ=\ngolang.org/x/text v0.3.3/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=\ngolang.org/x/text v0.3.6/go.mod h1:5Zoc/QRtKVWzQhOtBMvqHzDpF6irO9z98xDceosuGiQ=\ngolang.org/x/text v0.3.7/go.mod h1:u+2+/6zg+i71rQMx5EYifcz6MCKuco9NR6JIITiCfzQ=\ngolang.org/x/text v0.7.0/go.mod h1:mrYo+phRRbMaCq/xk9113O4dZlRixOauAjOtrjsXDZ8=\ngolang.org/x/text v0.9.0/go.mod h1:e1OnstbJyHTd6l/uOt8jFFHp6TRDWZR/bV3emEE/zU8=\ngolang.org/x/text v0.14.0/go.mod h1:18ZOQIKpY8NJVqYksKHtTdi31H5itFRjB5/qKTNYzSU=\ngolang.org/x/text v0.32.0 h1:ZD01bjUt1FQ9WJ0ClOL5vxgxOI/sVCNgX1YtKwcY0mU=\ngolang.org/x/text v0.32.0/go.mod h1:o/rUWzghvpD5TXrTIBuJU77MTaN0ljMWE47kxGJQ7jY=\ngolang.org/x/time v0.9.0 h1:EsRrnYcQiGH+5FfbgvV4AP7qEZstoyrHB0DzarOQ4ZY=\ngolang.org/x/time v0.9.0/go.mod h1:3BpzKBy/shNhVucY/MWOyx10tF3SFh9QdLuxbVysPQM=\ngolang.org/x/tools v0.0.0-20180917221912-90fa682c2a6e/go.mod h1:n7NCudcB/nEzxVGmLbDWY5pfWTLqBcC2KZ6jyYvM4mQ=\ngolang.org/x/tools v0.0.0-20191119224855-298f0cb1881e/go.mod h1:b+2E5dAYhXwXZwtnZ6UAqBI28+e2cm9otk0dWdXHAEo=\ngolang.org/x/tools v0.1.12/go.mod h1:hNGJHUnrk76NpqgfD5Aqm5Crs+Hm0VOH/i9J2+nxYbc=\ngolang.org/x/tools v0.6.0/go.mod h1:Xwgl3UAJ/d3gWutnCtw505GrjyAbvKui8lOU390QaIU=\ngolang.org/x/tools v0.40.0 h1:yLkxfA+Qnul4cs9QA3KnlFu0lVmd8JJfoq+E41uSutA=\ngolang.org/x/tools v0.40.0/go.mod h1:Ik/tzLRlbscWpqqMRjyWYDisX8bG13FrdXp3o4Sr9lc=\ngolang.org/x/tools/go/expect v0.1.1-deprecated h1:jpBZDwmgPhXsKZC6WhL20P4b/wmnpsEAGHaNy0n/rJM=\ngolang.org/x/tools/go/expect v0.1.1-deprecated/go.mod h1:eihoPOH+FgIqa3FpoTwguz/bVUSGBlGQU67vpBeOrBY=\ngolang.org/x/tools/go/packages/packagestest v0.1.1-deprecated h1:1h2MnaIAIXISqTFKdENegdpAgUXz6NrPEsbIeWaBRvM=\ngolang.org/x/tools/go/packages/packagestest v0.1.1-deprecated/go.mod h1:RVAQXBGNv1ib0J382/DPCRS/BPnsGebyM1Gj5VSDpG8=\ngolang.org/x/vuln v1.1.4 h1:Ju8QsuyhX3Hk8ma3CesTbO8vfJD9EvUBgHvkxHBzj0I=\ngolang.org/x/vuln v1.1.4/go.mod h1:F+45wmU18ym/ca5PLTPLsSzr2KppzswxPP603ldA67s=\ngolang.org/x/xerrors v0.0.0-20190717185122-a985d3407aa7/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngolang.org/x/xerrors v0.0.0-20191204190536-9bdfabe68543/go.mod h1:I/5z698sn9Ka8TeJc9MKroUUfqBBauWjQqLJ2OPfmY0=\ngonum.org/v1/gonum v0.16.0 h1:5+ul4Swaf3ESvrOnidPp4GZbzf0mxVQpDCYUQE7OJfk=\ngonum.org/v1/gonum v0.16.0/go.mod h1:fef3am4MQ93R2HHpKnLk4/Tbh/s0+wqD5nfa6Pnwy4E=\ngoogle.golang.org/genproto/googleapis/api v0.0.0-20251213004720-97cd9d5aeac2 h1:7LRqPCEdE4TP4/9psdaB7F2nhZFfBiGJomA5sojLWdU=\ngoogle.golang.org/genproto/googleapis/api v0.0.0-20251213004720-97cd9d5aeac2/go.mod h1:+rXWjjaukWZun3mLfjmVnQi18E1AsFbDN9QdJ5YXLto=\ngoogle.golang.org/genproto/googleapis/rpc v0.0.0-20251213004720-97cd9d5aeac2 h1:2I6GHUeJ/4shcDpoUlLs/2WPnhg7yJwvXtqcMJt9liA=\ngoogle.golang.org/genproto/googleapis/rpc v0.0.0-20251213004720-97cd9d5aeac2/go.mod h1:7i2o+ce6H/6BluujYR+kqX3GKH+dChPTQU19wjRPiGk=\ngoogle.golang.org/grpc v1.77.0 h1:wVVY6/8cGA6vvffn+wWK5ToddbgdU3d8MNENr4evgXM=\ngoogle.golang.org/grpc v1.77.0/go.mod h1:z0BY1iVj0q8E1uSQCjL9cppRj+gnZjzDnzV0dHhrNig=\ngoogle.golang.org/protobuf v1.36.11 h1:fV6ZwhNocDyBLK0dj+fg8ektcVegBBuEolpbTQyBNVE=\ngoogle.golang.org/protobuf v1.36.11/go.mod h1:HTf+CrKn2C3g5S8VImy6tdcUvCska2kB7j23XfzDpco=\ngopkg.in/check.v1 v0.0.0-20161208181325-20d25e280405/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=\ngopkg.in/check.v1 v1.0.0-20190902080502-41f04d3bba15/go.mod h1:Co6ibVJAznAaIkqp8huTwlJQCZ016jof/cbN4VW5Yz0=\ngopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c h1:Hei/4ADfdWqJk1ZMxUNpqntNwaWcugrBjAiHlqqRiVk=\ngopkg.in/check.v1 v1.0.0-20201130134442-10cb98267c6c/go.mod h1:JHkPIbrfpd72SG/EVd6muEfDQjcINNoR0C8j2r3qZ4Q=\ngopkg.in/warnings.v0 v0.1.2 h1:wFXVbFY8DY5/xOe1ECiWdKCzZlxgshcYVNkBHstARME=\ngopkg.in/warnings.v0 v0.1.2/go.mod h1:jksf8JmL6Qr/oQM2OXTHunEvvTAsrWBLb6OOjuVWRNI=\ngopkg.in/yaml.v2 v2.2.2/go.mod h1:hI93XBmqTisBFMUTm0b8Fm+jr3Dg1NNxqwp+5A1VGuI=\ngopkg.in/yaml.v2 v2.4.0 h1:D8xgwECY7CYvx+Y2n4sBz93Jn9JRvxdiyyo8CTfuKaY=\ngopkg.in/yaml.v2 v2.4.0/go.mod h1:RDklbk79AGWmwhnvt/jBztapEOGDOx6ZbXqjP6csGnQ=\ngopkg.in/yaml.v3 v3.0.0-20200313102051-9f266ea9e77c/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=\ngopkg.in/yaml.v3 v3.0.1 h1:fxVm/GzAzEWqLHuvctI91KS9hhNmmWOoWu0XTYJS7CA=\ngopkg.in/yaml.v3 v3.0.1/go.mod h1:K4uyk7z7BCEPqu6E+C64Yfv1cQ7kz7rIZviUmN+EgEM=\ngotest.tools/v3 v3.5.2 h1:7koQfIKdy+I8UTetycgUqXWSDwpgv193Ka+qRsmBY8Q=\ngotest.tools/v3 v3.5.2/go.mod h1:LtdLGcnqToBH83WByAAi/wiwSFCArdFIUV/xxN4pcjA=\nhonnef.co/go/tools v0.6.1 h1:R094WgE8K4JirYjBaOpz/AvTyUu/3wbmAoskKN/pxTI=\nhonnef.co/go/tools v0.6.1/go.mod h1:3puzxxljPCe8RGJX7BIy1plGbxEOZni5mR2aXe3/uk4=\nk8s.io/apimachinery v0.34.3 h1:/TB+SFEiQvN9HPldtlWOTp0hWbJ+fjU+wkxysf/aQnE=\nk8s.io/apimachinery v0.34.3/go.mod h1:/GwIlEcWuTX9zKIg2mbw0LRFIsXwrfoVxn+ef0X13lw=\nmvdan.cc/sh/v3 v3.12.0 h1:ejKUR7ONP5bb+UGHGEG/k9V5+pRVIyD+LsZz7o8KHrI=\nmvdan.cc/sh/v3 v3.12.0/go.mod h1:Se6Cj17eYSn+sNooLZiEUnNNmNxg0imoYlTu4CyaGyg=\npault.ag/go/debian v0.18.0 h1:nr0iiyOU5QlG1VPnhZLNhnCcHx58kukvBJp+dvaM6CQ=\npault.ag/go/debian v0.18.0/go.mod h1:JFl0XWRCv9hWBrB5MDDZjA5GSEs1X3zcFK/9kCNIUmE=\npault.ag/go/topsort v0.1.1 h1:L0QnhUly6LmTv0e3DEzbN2q6/FGgAcQvaEw65S53Bg4=\npault.ag/go/topsort v0.1.1/go.mod h1:r1kc/L0/FZ3HhjezBIPaNVhkqv8L0UJ9bxRuHRVZ0q4=\nsigs.k8s.io/json v0.0.0-20250730193827-2d320260d730 h1:IpInykpT6ceI+QxKBbEflcR5EXP7sU1kvOlxwZh5txg=\nsigs.k8s.io/json v0.0.0-20250730193827-2d320260d730/go.mod h1:mdzfpAEoE6DHQEN0uh9ZbOCuHbLK5wOm7dK4ctXE9Tg=\nsigs.k8s.io/yaml v1.6.0 h1:G8fkbMSAFqgEFgh4b1wmtzDnioxFCUgTZhlbj5P9QYs=\nsigs.k8s.io/yaml v1.6.0/go.mod h1:796bPqUfzR/0jLAl6XjHl3Ck7MiyVv8dbTdyT3/pMf4=\n"
},
{
"path": "internal/actorify/actorify.go",
"content": "// Package actorify lets you transform a parallel operation into a serialized\n// operation via the Actor pattern[1].\n//\n// [1]: https://en.wikipedia.org/wiki/Actor_model\npackage actorify\n\nimport (\n\t\"context\"\n\t\"errors\"\n)\n\nfunc z[Z any]() Z {\n\tvar z Z\n\treturn z\n}\n\nvar (\n\t// ErrActorDied is returned when the actor inbox or reply channel was closed.\n\tErrActorDied = errors.New(\"actorify: the actor inbox or reply channel was closed\")\n)\n\n// Handler is a function alias for the underlying logic the Actor should call.\ntype Handler[Input, Output any] func(ctx context.Context, input Input) (Output, error)\n\n// Actor is a serializing wrapper that runs a function in a background goroutine.\n// Whenever the Call method is invoked, a message is sent to the actor's inbox and then\n// the callee waits for a response. Depending on how busy the actor is, this may take\n// a moment.\ntype Actor[Input, Output any] struct {\n\thandler Handler[Input, Output]\n\tinbox chan *message[Input, Output]\n}\n\ntype message[Input, Output any] struct {\n\tctx context.Context\n\targ Input\n\treply chan reply[Output]\n}\n\ntype reply[Output any] struct {\n\toutput Output\n\terr error\n}\n\n// New constructs a new Actor and starts its background thread. Cancel the context and you cancel\n// the Actor.\nfunc New[Input, Output any](ctx context.Context, handler Handler[Input, Output]) *Actor[Input, Output] {\n\tresult := &Actor[Input, Output]{\n\t\thandler: handler,\n\t\tinbox: make(chan *message[Input, Output], 32),\n\t}\n\n\tgo result.handle(ctx)\n\n\treturn result\n}\n\nfunc (a *Actor[Input, Output]) handle(ctx context.Context) {\n\tfor {\n\t\tselect {\n\t\tcase <-ctx.Done():\n\t\t\tclose(a.inbox)\n\t\t\treturn\n\t\tcase msg, ok := <-a.inbox:\n\t\t\tif !ok {\n\t\t\t\tif msg.reply != nil {\n\t\t\t\t\tclose(msg.reply)\n\t\t\t\t}\n\n\t\t\t\treturn\n\t\t\t}\n\n\t\t\tresult, err := a.handler(msg.ctx, msg.arg)\n\n\t\t\treply := reply[Output]{\n\t\t\t\toutput: result,\n\t\t\t\terr: err,\n\t\t\t}\n\n\t\t\tmsg.reply <- reply\n\t\t}\n\t}\n}\n\n// Call calls the Actor with a given Input and returns the handler's Output.\n//\n// This only works with unary functions by design. If you need to have more inputs, define\n// a struct type to use as a container.\nfunc (a *Actor[Input, Output]) Call(ctx context.Context, input Input) (Output, error) {\n\treplyCh := make(chan reply[Output])\n\n\ta.inbox <- &message[Input, Output]{\n\t\targ: input,\n\t\treply: replyCh,\n\t}\n\n\tselect {\n\tcase reply, ok := <-replyCh:\n\t\tif !ok {\n\t\t\treturn z[Output](), ErrActorDied\n\t\t}\n\n\t\treturn reply.output, reply.err\n\tcase <-ctx.Done():\n\t\treturn z[Output](), context.Cause(ctx)\n\t}\n}\n"
},
{
"path": "internal/clampip.go",
"content": "package internal\n\nimport \"net/netip\"\n\nfunc ClampIP(addr netip.Addr) (netip.Prefix, bool) {\n\tswitch {\n\tcase addr.Is4():\n\t\tresult, err := addr.Prefix(24)\n\t\tif err != nil {\n\t\t\treturn netip.Prefix{}, false\n\t\t}\n\t\treturn result, true\n\n\tcase addr.Is4In6():\n\t\t// Extract the IPv4 address from IPv4-mapped IPv6 and clamp it\n\t\tipv4 := addr.Unmap()\n\t\tresult, err := ipv4.Prefix(24)\n\t\tif err != nil {\n\t\t\treturn netip.Prefix{}, false\n\t\t}\n\t\treturn result, true\n\n\tcase addr.Is6():\n\t\tresult, err := addr.Prefix(48)\n\t\tif err != nil {\n\t\t\treturn netip.Prefix{}, false\n\t\t}\n\t\treturn result, true\n\n\tdefault:\n\t\treturn netip.Prefix{}, false\n\t}\n}\n"
},
{
"path": "internal/clampip_test.go",
"content": "package internal\n\nimport (\n\t\"net/netip\"\n\t\"testing\"\n)\n\nfunc TestClampIP(t *testing.T) {\n\ttests := []struct {\n\t\tname string\n\t\tinput string\n\t\texpected string\n\t}{\n\t\t// IPv4 addresses\n\t\t{\n\t\t\tname: \"IPv4 normal address\",\n\t\t\tinput: \"192.168.1.100\",\n\t\t\texpected: \"192.168.1.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4 boundary - network address\",\n\t\t\tinput: \"192.168.1.0\",\n\t\t\texpected: \"192.168.1.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4 boundary - broadcast address\",\n\t\t\tinput: \"192.168.1.255\",\n\t\t\texpected: \"192.168.1.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4 class A address\",\n\t\t\tinput: \"10.0.0.1\",\n\t\t\texpected: \"10.0.0.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4 loopback\",\n\t\t\tinput: \"127.0.0.1\",\n\t\t\texpected: \"127.0.0.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4 link-local\",\n\t\t\tinput: \"169.254.0.1\",\n\t\t\texpected: \"169.254.0.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4 public address\",\n\t\t\tinput: \"203.0.113.1\",\n\t\t\texpected: \"203.0.113.0/24\",\n\t\t},\n\n\t\t// IPv6 addresses\n\t\t{\n\t\t\tname: \"IPv6 normal address\",\n\t\t\tinput: \"2001:db8::1\",\n\t\t\texpected: \"2001:db8::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 with full expansion\",\n\t\t\tinput: \"2001:0db8:0000:0000:0000:0000:0000:0001\",\n\t\t\texpected: \"2001:db8::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 loopback\",\n\t\t\tinput: \"::1\",\n\t\t\texpected: \"::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 unspecified address\",\n\t\t\tinput: \"::\",\n\t\t\texpected: \"::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 link-local\",\n\t\t\tinput: \"fe80::1\",\n\t\t\texpected: \"fe80::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 unique local\",\n\t\t\tinput: \"fc00::1\",\n\t\t\texpected: \"fc00::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 documentation prefix\",\n\t\t\tinput: \"2001:db8:abcd:ef01::1234\",\n\t\t\texpected: \"2001:db8:abcd::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 global unicast\",\n\t\t\tinput: \"2606:4700:4700::1111\",\n\t\t\texpected: \"2606:4700:4700::/48\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 multicast\",\n\t\t\tinput: \"ff02::1\",\n\t\t\texpected: \"ff02::/48\",\n\t\t},\n\n\t\t// IPv4-mapped IPv6 addresses\n\t\t{\n\t\t\tname: \"IPv4-mapped IPv6 address\",\n\t\t\tinput: \"::ffff:192.168.1.100\",\n\t\t\texpected: \"192.168.1.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4-mapped IPv6 with different format\",\n\t\t\tinput: \"::ffff:10.0.0.1\",\n\t\t\texpected: \"10.0.0.0/24\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4-mapped IPv6 loopback\",\n\t\t\tinput: \"::ffff:127.0.0.1\",\n\t\t\texpected: \"127.0.0.0/24\",\n\t\t},\n\t}\n\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\taddr := netip.MustParseAddr(tt.input)\n\n\t\t\tresult, ok := ClampIP(addr)\n\t\t\tif !ok {\n\t\t\t\tt.Fatalf(\"ClampIP(%s) returned false, want true\", tt.input)\n\t\t\t}\n\n\t\t\tif result.String() != tt.expected {\n\t\t\t\tt.Errorf(\"ClampIP(%s) = %s, want %s\", tt.input, result.String(), tt.expected)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestClampIPSuccess(t *testing.T) {\n\t// Test that valid inputs return success\n\ttests := []struct {\n\t\tname string\n\t\tinput string\n\t}{\n\t\t{\n\t\t\tname: \"IPv4 address\",\n\t\t\tinput: \"192.168.1.100\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv6 address\",\n\t\t\tinput: \"2001:db8::1\",\n\t\t},\n\t\t{\n\t\t\tname: \"IPv4-mapped IPv6\",\n\t\t\tinput: \"::ffff:192.168.1.100\",\n\t\t},\n\t}\n\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\taddr := netip.MustParseAddr(tt.input)\n\n\t\t\tresult, ok := ClampIP(addr)\n\t\t\tif !ok {\n\t\t\t\tt.Fatalf(\"ClampIP(%s) returned false, want true\", tt.input)\n\t\t\t}\n\n\t\t\t// For valid inputs, we should get the clamped prefix\n\t\t\tif addr.Is4() || addr.Is4In6() {\n\t\t\t\tif result.Bits() != 24 {\n\t\t\t\t\tt.Errorf(\"Expected 24 bits for IPv4, got %d\", result.Bits())\n\t\t\t\t}\n\t\t\t} else if addr.Is6() {\n\t\t\t\tif result.Bits() != 48 {\n\t\t\t\t\tt.Errorf(\"Expected 48 bits for IPv6, got %d\", result.Bits())\n\t\t\t\t}\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestClampIPZeroValue(t *testing.T) {\n\t// Test that when ClampIP fails, it returns zero value\n\t// Note: It's hard to make addr.Prefix() fail with valid inputs,\n\t// so this test demonstrates the expected behavior\n\taddr := netip.MustParseAddr(\"192.168.1.100\")\n\n\t// Manually create a zero value for comparison\n\tzeroPrefix := netip.Prefix{}\n\n\t// Call ClampIP - it should succeed with valid input\n\tresult, ok := ClampIP(addr)\n\n\t// Verify the function succeeded\n\tif !ok {\n\t\tt.Error(\"ClampIP should succeed with valid input\")\n\t}\n\n\t// Verify that the result is not a zero value\n\tif result == zeroPrefix {\n\t\tt.Error(\"Result should not be zero value for successful operation\")\n\t}\n}\n\nfunc TestClampIPSpecialCases(t *testing.T) {\n\ttests := []struct {\n\t\tname string\n\t\tinput string\n\t\texpectedPrefix int\n\t\texpectedNetwork string\n\t}{\n\t\t{\n\t\t\tname: \"Minimum IPv4\",\n\t\t\tinput: \"0.0.0.0\",\n\t\t\texpectedPrefix: 24,\n\t\t\texpectedNetwork: \"0.0.0.0\",\n\t\t},\n\t\t{\n\t\t\tname: \"Maximum IPv4\",\n\t\t\tinput: \"255.255.255.255\",\n\t\t\texpectedPrefix: 24,\n\t\t\texpectedNetwork: \"255.255.255.0\",\n\t\t},\n\t\t{\n\t\t\tname: \"Minimum IPv6\",\n\t\t\tinput: \"::\",\n\t\t\texpectedPrefix: 48,\n\t\t\texpectedNetwork: \"::\",\n\t\t},\n\t\t{\n\t\t\tname: \"Maximum IPv6 prefix part\",\n\t\t\tinput: \"ffff:ffff:ffff::\",\n\t\t\texpectedPrefix: 48,\n\t\t\texpectedNetwork: \"ffff:ffff:ffff::\",\n\t\t},\n\t}\n\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\taddr := netip.MustParseAddr(tt.input)\n\n\t\t\tresult, ok := ClampIP(addr)\n\t\t\tif !ok {\n\t\t\t\tt.Fatalf(\"ClampIP(%s) returned false, want true\", tt.input)\n\t\t\t}\n\n\t\t\tif result.Bits() != tt.expectedPrefix {\n\t\t\t\tt.Errorf(\"ClampIP(%s) bits = %d, want %d\", tt.input, result.Bits(), tt.expectedPrefix)\n\t\t\t}\n\n\t\t\tif result.Addr().String() != tt.expectedNetwork {\n\t\t\t\tt.Errorf(\"ClampIP(%s) network = %s, want %s\", tt.input, result.Addr().String(), tt.expectedNetwork)\n\t\t\t}\n\t\t})\n\t}\n}\n\n// Benchmark to ensure the function is performant\nfunc BenchmarkClampIP(b *testing.B) {\n\tipv4 := netip.MustParseAddr(\"192.168.1.100\")\n\tipv6 := netip.MustParseAddr(\"2001:db8::1\")\n\tipv4mapped := netip.MustParseAddr(\"::ffff:192.168.1.100\")\n\n\tb.Run(\"IPv4\", func(b *testing.B) {\n\t\tfor i := 0; i < b.N; i++ {\n\t\t\tClampIP(ipv4)\n\t\t}\n\t})\n\n\tb.Run(\"IPv6\", func(b *testing.B) {\n\t\tfor i := 0; i < b.N; i++ {\n\t\t\tClampIP(ipv6)\n\t\t}\n\t})\n\n\tb.Run(\"IPv4-mapped\", func(b *testing.B) {\n\t\tfor i := 0; i < b.N; i++ {\n\t\t\tClampIP(ipv4mapped)\n\t\t}\n\t})\n}"
},
{
"path": "internal/dns/cache.go",
"content": "package dns\n\nimport (\n\t\"log/slog\"\n\t\"time\"\n\n\t\"github.com/TecharoHQ/anubis/lib/store\"\n\n\t_ \"github.com/TecharoHQ/anubis/lib/store/all\"\n)\n\ntype DnsCache struct {\n\tforward store.JSON[[]string]\n\treverse store.JSON[[]string]\n\tforwardTTL time.Duration\n\treverseTTL time.Duration\n}\n\nfunc NewDNSCache(forwardTTL int, reverseTTL int, backend store.Interface) *DnsCache {\n\treturn &DnsCache{\n\t\tforward: store.JSON[[]string]{\n\t\t\tUnderlying: backend,\n\t\t\tPrefix: \"forwardDNS\",\n\t\t},\n\t\treverse: store.JSON[[]string]{\n\t\t\tUnderlying: backend,\n\t\t\tPrefix: \"reverseDNS\",\n\t\t},\n\t\tforwardTTL: time.Duration(forwardTTL) * time.Second,\n\t\treverseTTL: time.Duration(reverseTTL) * time.Second,\n\t}\n}\n\nfunc (d *Dns) getCachedForward(host string) ([]string, bool) {\n\tif d.cache == nil {\n\t\treturn nil, false\n\t}\n\tif cached, err := d.cache.forward.Get(d.ctx, host); err == nil {\n\t\tslog.Debug(\"DNS: forward cache hit\", \"name\", host, \"ips\", cached)\n\t\treturn cached, true\n\t}\n\tslog.Debug(\"DNS: forward cache miss\", \"name\", host)\n\treturn nil, false\n}\n\nfunc (d *Dns) getCachedReverse(addr string) ([]string, bool) {\n\tif d.cache == nil {\n\t\treturn nil, false\n\t}\n\tif cached, err := d.cache.reverse.Get(d.ctx, addr); err == nil {\n\t\tslog.Debug(\"DNS: reverse cache hit\", \"addr\", addr, \"names\", cached)\n\t\treturn cached, true\n\t}\n\tslog.Debug(\"DNS: reverse cache miss\", \"addr\", addr)\n\treturn nil, false\n}\n\nfunc (d *Dns) forwardCachePut(host string, entries []string) {\n\tif d.cache == nil {\n\t\treturn\n\t}\n\td.cache.forward.Set(d.ctx, host, entries, d.cache.forwardTTL)\n}\n\nfunc (d *Dns) reverseCachePut(addr string, entries []string) {\n\tif d.cache == nil {\n\t\treturn\n\t}\n\td.cache.reverse.Set(d.ctx, addr, entries, d.cache.reverseTTL)\n}\n"
},
{
"path": "internal/dns/dns.go",
"content": "package dns\n\nimport (\n\t\"context\"\n\t\"encoding/hex\"\n\t\"errors\"\n\t\"fmt\"\n\t\"log/slog\"\n\t\"net\"\n\t\"regexp\"\n\t\"slices\"\n\t\"strings\"\n)\n\nvar (\n\tDNSLookupAddr = net.LookupAddr\n\tDNSLookupHost = net.LookupHost\n)\n\ntype Dns struct {\n\tcache *DnsCache\n\tctx context.Context\n}\n\nfunc New(ctx context.Context, cache *DnsCache) *Dns {\n\treturn &Dns{\n\t\tcache: cache,\n\t\tctx: ctx,\n\t}\n}\n\n// ReverseDNS performs a reverse DNS lookup for the given IP address and trims the trailing dot from the results.\nfunc (d *Dns) ReverseDNS(addr string) ([]string, error) {\n\tslog.Debug(\"DNS: performing reverse lookup\", \"addr\", addr)\n\n\tif cached, ok := d.getCachedReverse(addr); ok {\n\t\treturn cached, nil\n\t}\n\n\tnames, err := DNSLookupAddr(addr)\n\tif err != nil {\n\t\tif dnsErr, ok := err.(*net.DNSError); ok && dnsErr.IsNotFound {\n\t\t\tslog.Debug(\"DNS: no PTR record found\", \"addr\", addr)\n\t\t\treturn []string{}, nil\n\t\t}\n\t\tslog.Error(\"DNS: reverse lookup failed\", \"addr\", addr, \"err\", err)\n\t\treturn nil, err\n\t}\n\n\tslog.Debug(\"DNS: reverse lookup successful\", \"addr\", addr, \"names\", names)\n\n\ttrimmedNames := make([]string, len(names))\n\tfor i, name := range names {\n\t\ttrimmedNames[i] = strings.TrimSuffix(name, \".\")\n\t}\n\td.reverseCachePut(addr, trimmedNames)\n\n\treturn trimmedNames, nil\n}\n\n// LookupHost performs a forward DNS lookup for the given hostname.\nfunc (d *Dns) LookupHost(host string) ([]string, error) {\n\tslog.Debug(\"DNS: performing forward lookup\", \"host\", host)\n\n\tif cached, ok := d.getCachedForward(host); ok {\n\t\treturn cached, nil\n\t}\n\n\taddrs, err := DNSLookupHost(host)\n\tif err != nil {\n\t\tif dnsErr, ok := err.(*net.DNSError); ok && dnsErr.IsNotFound {\n\t\t\tslog.Debug(\"DNS: no A/AAAA record found\", \"host\", host)\n\t\t\treturn []string{}, nil\n\t\t}\n\t\tslog.Error(\"DNS: forward lookup failed\", \"host\", host, \"err\", err)\n\t\treturn nil, err\n\t}\n\n\tslog.Debug(\"DNS: forward lookup successful\", \"host\", host, \"addrs\", addrs)\n\td.forwardCachePut(host, addrs)\n\treturn addrs, nil\n}\n\n// verifyFCrDNSInternal performs the second half of the FCrDNS check, using a\n// pre-fetched list of names to perform the forward lookups.\nfunc (d *Dns) verifyFCrDNSInternal(addr string, names []string) bool {\n\tfor _, name := range names {\n\t\tif cached, err := d.LookupHost(name); err == nil {\n\t\t\tif slices.Contains(cached, addr) {\n\t\t\t\tslog.Info(\"DNS: forward lookup confirmed original IP\", \"name\", name, \"addr\", addr)\n\t\t\t\treturn true\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t}\n\n\tslog.Info(\"DNS: could not confirm original IP in forward lookups\", \"addr\", addr)\n\treturn false\n}\n\n// VerifyFCrDNS performs a forward-confirmed reverse DNS (FCrDNS) lookup for the given IP address,\n// optionally matching against a provided pattern.\nfunc (d *Dns) VerifyFCrDNS(addr string, pattern *string) bool {\n\tvar patternVal string\n\tif pattern != nil {\n\t\tpatternVal = *pattern\n\t}\n\tslog.Debug(\"DNS: performing FCrDNS lookup\", \"addr\", addr, \"pattern\", patternVal)\n\n\tnames, err := d.ReverseDNS(addr)\n\tif err != nil {\n\t\treturn false\n\t}\n\tif len(names) == 0 {\n\t\treturn pattern == nil // If no pattern specified, check is passed\n\t}\n\n\t// If a pattern is provided, check for a match.\n\tif pattern != nil {\n\t\tanyNameMatched := false\n\t\tfor _, name := range names {\n\t\t\tmatched, err := regexp.MatchString(*pattern, name)\n\t\t\tif err != nil {\n\t\t\t\tslog.Error(\"DNS: verifyFCrDNS invalid regex pattern\", \"err\", err)\n\t\t\t\treturn false // Invalid pattern is a failure.\n\t\t\t}\n\t\t\tif matched {\n\t\t\t\tanyNameMatched = true\n\t\t\t\tbreak\n\t\t\t}\n\t\t}\n\n\t\tif !anyNameMatched {\n\t\t\tslog.Debug(\"DNS: FCrDNS no PTR matches the pattern\", \"addr\", addr, \"pattern\", *pattern)\n\t\t\treturn false\n\t\t}\n\t\tslog.Debug(\"DNS: FCrDNS PTR matched pattern, proceeding with forward check\", \"addr\", addr, \"pattern\", *pattern)\n\t}\n\n\t// If we're here, either there was no pattern, or the pattern matched.\n\t// Proceed with the forward lookup confirmation.\n\treturn d.verifyFCrDNSInternal(addr, names)\n}\n\n// ArpaReverseIP performs translation from ip v4/v6 to arpa reverse notation\nfunc (d *Dns) ArpaReverseIP(addr string) (string, error) {\n\tip := net.ParseIP(addr)\n\tif ip == nil {\n\t\treturn addr, errors.New(\"invalid IP address\")\n\t}\n\n\tif ipv4 := ip.To4(); ipv4 != nil {\n\t\treturn fmt.Sprintf(\"%d.%d.%d.%d\", ipv4[3], ipv4[2], ipv4[1], ipv4[0]), nil\n\t}\n\n\tipv6 := ip.To16()\n\tif ipv6 == nil {\n\t\treturn addr, errors.New(\"invalid IPv6 address\")\n\t}\n\n\thexBytes := make([]byte, hex.EncodedLen(len(ipv6)))\n\thex.Encode(hexBytes, ipv6)\n\n\tvar sb strings.Builder\n\tsb.Grow(len(hexBytes)*2 - 1)\n\n\tfor i := len(hexBytes) - 1; i >= 0; i-- {\n\t\tsb.WriteByte(hexBytes[i])\n\t\tif i > 0 {\n\t\t\tsb.WriteByte('.')\n\t\t}\n\t}\n\treturn sb.String(), nil\n}\n"
},
{
"path": "internal/dns/dns_test.go",
"content": "package dns\n\nimport (\n\t\"context\"\n\t\"errors\"\n\t\"net\"\n\t\"reflect\"\n\t\"testing\"\n\t\"time\"\n\n\t\"github.com/TecharoHQ/anubis/lib/store/memory\"\n)\n\n// newTestDNS is a helper function to create a new Dns object with an in-memory cache for testing.\nfunc newTestDNS(forwardTTL int, reverseTTL int) *Dns {\n\tctx := context.Background()\n\tmemStore := memory.New(ctx)\n\tcache := NewDNSCache(forwardTTL, reverseTTL, memStore)\n\treturn New(ctx, cache)\n}\n\n// mockLookupAddr is a mock implementation of the net.LookupAddr function.\nfunc mockLookupAddr(addr string) ([]string, error) {\n\tswitch addr {\n\tcase \"8.8.8.8\":\n\t\treturn []string{\"dns.google.\"}, nil\n\tcase \"1.1.1.1\":\n\t\treturn []string{\"one.one.one.one.\"}, nil\n\tcase \"208.67.222.222\":\n\t\treturn []string{\"resolver1.opendns.com.\"}, nil\n\tcase \"9.9.9.9\":\n\t\treturn nil, &net.DNSError{Err: \"no such host\", Name: \"9.9.9.9\", IsNotFound: true}\n\tcase \"1.2.3.4\":\n\t\treturn nil, errors.New(\"unknown error\")\n\tdefault:\n\t\treturn nil, &net.DNSError{Err: \"no such host\", Name: addr, IsNotFound: true}\n\t}\n}\n\n// mockLookupHost is a mock implementation of the net.LookupHost function.\nfunc mockLookupHost(host string) ([]string, error) {\n\tswitch host {\n\tcase \"dns.google\":\n\t\treturn []string{\"8.8.8.8\", \"8.8.4.4\"}, nil\n\tcase \"one.one.one.one\":\n\t\treturn []string{\"1.1.1.1\", \"1.0.0.1\"}, nil\n\tcase \"resolver1.opendns.com\":\n\t\treturn []string{\"208.67.222.222\"}, nil\n\tcase \"example.com\":\n\t\treturn nil, &net.DNSError{Err: \"no such host\", Name: \"example.com\", IsNotFound: true}\n\tdefault:\n\t\treturn nil, &net.DNSError{Err: \"no such host\", Name: host, IsNotFound: true}\n\t}\n}\n\nfunc TestMain(m *testing.M) {\n\t// Before all tests\n\toriginalLookupAddr := DNSLookupAddr\n\toriginalLookupHost := DNSLookupHost\n\n\tDNSLookupAddr = mockLookupAddr\n\tDNSLookupHost = mockLookupHost\n\n\t// Run tests\n\texitCode := m.Run()\n\n\t// After all tests\n\tDNSLookupAddr = originalLookupAddr\n\tDNSLookupHost = originalLookupHost\n\n\t// Exit\n\tif exitCode != 0 {\n\t\tpanic(exitCode)\n\t}\n}\n\nfunc TestDns_ArpaReverseIP(t *testing.T) {\n\td := newTestDNS(0, 0)\n\ttests := []struct {\n\t\tname string\n\t\tip string\n\t\twant string\n\t\twantErr bool\n\t}{\n\t\t{\"ipv4\", \"192.0.2.1\", \"1.2.0.192\", false},\n\t\t{\"ipv6\", \"2001:db8::1\", \"1.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2\", false},\n\t\t{\"invalid ip\", \"invalid\", \"invalid\", true},\n\t\t{\"ipv4-mapped ipv6\", \"::ffff:192.0.2.1\", \"1.2.0.192\", false},\n\t}\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\tgot, err := d.ArpaReverseIP(tt.ip)\n\t\t\tif (err != nil) != tt.wantErr {\n\t\t\t\tt.Errorf(\"ArpaReverseIP() error = %v, wantErr %v\", err, tt.wantErr)\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif got != tt.want {\n\t\t\t\tt.Errorf(\"ArpaReverseIP() = %v, want %v\", got, tt.want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestDns_ReverseDNS(t *testing.T) {\n\td := newTestDNS(1, 1) // short TTL for testing cache\n\n\t// First call - cache miss\n\tt.Run(\"cache miss\", func(t *testing.T) {\n\t\tgot, err := d.ReverseDNS(\"8.8.8.8\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"ReverseDNS() error = %v\", err)\n\t\t}\n\t\twant := []string{\"dns.google\"}\n\t\tif !reflect.DeepEqual(got, want) {\n\t\t\tt.Errorf(\"ReverseDNS() = %v, want %v\", got, want)\n\t\t}\n\t})\n\n\t// Second call - cache hit\n\tt.Run(\"cache hit\", func(t *testing.T) {\n\t\t// Temporarily replace lookup function to ensure cache is used\n\t\toriginalLookupAddr := DNSLookupAddr\n\t\tDNSLookupAddr = func(addr string) ([]string, error) {\n\t\t\treturn nil, errors.New(\"should not be called\")\n\t\t}\n\t\tdefer func() { DNSLookupAddr = originalLookupAddr }()\n\n\t\tgot, err := d.ReverseDNS(\"8.8.8.8\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"ReverseDNS() error = %v\", err)\n\t\t}\n\t\twant := []string{\"dns.google\"}\n\t\tif !reflect.DeepEqual(got, want) {\n\t\t\tt.Errorf(\"ReverseDNS() = %v, want %v\", got, want)\n\t\t}\n\t})\n\n\t// Test cache expiration\n\tt.Run(\"cache expiration\", func(t *testing.T) {\n\t\ttime.Sleep(2 * time.Second)\n\t\t// Now the cache should be expired\n\t\t// We expect the mock to be called again\n\t\t// To test this we will change the mock to return something different\n\t\toriginalLookupAddr := DNSLookupAddr\n\t\tDNSLookupAddr = func(addr string) ([]string, error) {\n\t\t\tif addr == \"8.8.8.8\" {\n\t\t\t\treturn []string{\"expired.google.\"}, nil\n\t\t\t}\n\t\t\treturn mockLookupAddr(addr)\n\t\t}\n\t\tdefer func() { DNSLookupAddr = originalLookupAddr }()\n\n\t\tgot, err := d.ReverseDNS(\"8.8.8.8\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"ReverseDNS() error = %v\", err)\n\t\t}\n\t\twant := []string{\"expired.google\"}\n\t\tif !reflect.DeepEqual(got, want) {\n\t\t\tt.Errorf(\"ReverseDNS() = %v, want %v\", got, want)\n\t\t}\n\t})\n\n\t// Test not found\n\tt.Run(\"not found\", func(t *testing.T) {\n\t\tgot, err := d.ReverseDNS(\"9.9.9.9\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"ReverseDNS() error = %v\", err)\n\t\t}\n\t\tif len(got) != 0 {\n\t\t\tt.Errorf(\"ReverseDNS() = %v, want empty slice\", got)\n\t\t}\n\t})\n}\n\nfunc TestDns_LookupHost(t *testing.T) {\n\td := newTestDNS(1, 1)\n\n\tt.Run(\"cache miss\", func(t *testing.T) {\n\t\tgot, err := d.LookupHost(\"dns.google\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"LookupHost() error = %v\", err)\n\t\t}\n\t\twant := []string{\"8.8.8.8\", \"8.8.4.4\"}\n\t\tif !reflect.DeepEqual(got, want) {\n\t\t\tt.Errorf(\"LookupHost() = %v, want %v\", got, want)\n\t\t}\n\t})\n\n\tt.Run(\"cache hit\", func(t *testing.T) {\n\t\toriginalLookupHost := DNSLookupHost\n\t\tDNSLookupHost = func(host string) ([]string, error) {\n\t\t\treturn nil, errors.New(\"should not be called\")\n\t\t}\n\t\tdefer func() { DNSLookupHost = originalLookupHost }()\n\n\t\tgot, err := d.LookupHost(\"dns.google\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"LookupHost() error = %v\", err)\n\t\t}\n\t\twant := []string{\"8.8.8.8\", \"8.8.4.4\"}\n\t\tif !reflect.DeepEqual(got, want) {\n\t\t\tt.Errorf(\"LookupHost() = %v, want %v\", got, want)\n\t\t}\n\t})\n\n\tt.Run(\"cache expiration\", func(t *testing.T) {\n\t\ttime.Sleep(2 * time.Second)\n\t\toriginalLookupHost := DNSLookupHost\n\t\tDNSLookupHost = func(host string) ([]string, error) {\n\t\t\tif host == \"dns.google\" {\n\t\t\t\treturn []string{\"9.9.9.9\"}, nil\n\t\t\t}\n\t\t\treturn mockLookupHost(host)\n\t\t}\n\t\tdefer func() { DNSLookupHost = originalLookupHost }()\n\n\t\tgot, err := d.LookupHost(\"dns.google\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"LookupHost() error = %v\", err)\n\t\t}\n\t\twant := []string{\"9.9.9.9\"}\n\t\tif !reflect.DeepEqual(got, want) {\n\t\t\tt.Errorf(\"LookupHost() = %v, want %v\", got, want)\n\t\t}\n\t})\n\n\tt.Run(\"not found\", func(t *testing.T) {\n\t\tgot, err := d.LookupHost(\"example.com\")\n\t\tif err != nil {\n\t\t\tt.Fatalf(\"LookupHost() error = %v\", err)\n\t\t}\n\t\tif len(got) != 0 {\n\t\t\tt.Errorf(\"LookupHost() = %v, want empty slice\", got)\n\t\t}\n\t})\n}\n\nfunc TestDns_VerifyFCrDNS(t *testing.T) {\n\td := newTestDNS(1, 1)\n\n\t// Helper to convert string to *string\n\tp := func(s string) *string {\n\t\treturn &s\n\t}\n\n\ttests := []struct {\n\t\tname string\n\t\tip string\n\t\tpattern *string\n\t\twant bool\n\t}{\n\t\t// Cases without pattern\n\t\t{\"valid no pattern\", \"8.8.8.8\", nil, true},\n\t\t{\"valid partial no pattern\", \"1.1.1.1\", nil, true},\n\t\t{\"not found no pattern\", \"9.9.9.9\", nil, true},\n\t\t{\"unknown error no pattern\", \"1.2.3.4\", nil, false},\n\n\t\t// Cases with pattern\n\t\t{\"valid match\", \"8.8.8.8\", p(`.*\\.google$`), true},\n\t\t{\"valid no match\", \"8.8.8.8\", p(`\\.com$`), false},\n\t\t{\"not found with pattern\", \"9.9.9.9\", p(\".*\"), false},\n\t\t{\"unknown error with pattern\", \"1.2.3.4\", p(\".*\"), false},\n\t\t{\"invalid pattern\", \"8.8.8.8\", p(`[`), false},\n\t}\n\tfor _, tt := range tests {\n\t\tt.Run(tt.name, func(t *testing.T) {\n\t\t\tif got := d.VerifyFCrDNS(tt.ip, tt.pattern); got != tt.want {\n\t\t\t\tt.Errorf(\"VerifyFCrDNS() = %v, want %v\", got, tt.want)\n\t\t\t}\n\t\t})\n\t}\n\n\tt.Run(\"reverse cache hit\", func(t *testing.T) {\n\t\t// Prime the cache\n\t\tif got := d.VerifyFCrDNS(\"8.8.8.8\", nil); got != true {\n\t\t\tt.Fatalf(\"VerifyFCrDNS() priming failed, got %v, want true\", got)\n\t\t}\n\n\t\t// Now test with a failing lookup to ensure cache is used\n\t\toriginalLookupAddr := DNSLookupAddr\n\t\tDNSLookupAddr = func(addr string) ([]string, error) {\n\t\t\treturn nil, errors.New(\"should not be called\")\n\t\t}\n\t\tdefer func() { DNSLookupAddr = originalLookupAddr }()\n\n\t\tif got := d.VerifyFCrDNS(\"8.8.8.8\", nil); got != true {\n\t\t\tt.Errorf(\"VerifyFCrDNS() = %v, want true\", got)\n\t\t}\n\t})\n\n\tt.Run(\"forward cache hit\", func(t *testing.T) {\n\t\t// Prime the cache\n\t\tif got := d.VerifyFCrDNS(\"8.8.8.8\", nil); got != true {\n\t\t\tt.Fatalf(\"VerifyFCrDNS() priming failed, got %v, want true\", got)\n\t\t}\n\n\t\t// Now test with a failing lookup to ensure cache is used\n\t\toriginalLookupHost := DNSLookupHost\n\t\tDNSLookupHost = func(host string) ([]string, error) {\n\t\t\treturn nil, errors.New(\"should not be called\")\n\t\t}\n\t\tdefer func() { DNSLookupHost = originalLookupHost }()\n\n\t\tif got := d.VerifyFCrDNS(\"8.8.8.8\", nil); got != true {\n\t\t\tt.Errorf(\"VerifyFCrDNS() = %v, want true\", got)\n\t\t}\n\t})\n}\n"
},
{
"path": "internal/dnsbl/dnsbl.go",
"content": "package dnsbl\n\nimport (\n\t\"errors\"\n\t\"fmt\"\n\t\"net\"\n\t\"strings\"\n)\n\n//go:generate go tool golang.org/x/tools/cmd/stringer -type=DroneBLResponse\n\ntype DroneBLResponse byte\n\nconst (\n\tAllGood DroneBLResponse = 0\n\tIRCDrone DroneBLResponse = 3\n\tBottler DroneBLResponse = 5\n\tUnknownSpambotOrDrone DroneBLResponse = 6\n\tDDOSDrone DroneBLResponse = 7\n\tSOCKSProxy DroneBLResponse = 8\n\tHTTPProxy DroneBLResponse = 9\n\tProxyChain DroneBLResponse = 10\n\tOpenProxy DroneBLResponse = 11\n\tOpenDNSResolver DroneBLResponse = 12\n\tBruteForceAttackers DroneBLResponse = 13\n\tOpenWingateProxy DroneBLResponse = 14\n\tCompromisedRouter DroneBLResponse = 15\n\tAutoRootingWorms DroneBLResponse = 16\n\tAutoDetectedBotIP DroneBLResponse = 17\n\tUnknown DroneBLResponse = 255\n)\n\nfunc Reverse(ip net.IP) string {\n\tif ip.To4() != nil {\n\t\treturn reverse4(ip)\n\t}\n\n\treturn reverse6(ip)\n}\n\nfunc reverse4(ip net.IP) string {\n\tsplitAddress := strings.Split(ip.String(), \".\")\n\n\t// swap first and last octet\n\tsplitAddress[0], splitAddress[3] = splitAddress[3], splitAddress[0]\n\t// swap middle octets\n\tsplitAddress[1], splitAddress[2] = splitAddress[2], splitAddress[1]\n\n\treturn strings.Join(splitAddress, \".\")\n}\n\nfunc reverse6(ip net.IP) string {\n\tipBytes := []byte(ip)\n\tvar sb strings.Builder\n\n\tfor i := len(ipBytes) - 1; i >= 0; i-- {\n\t\t// Split the byte into two nibbles\n\t\thighNibble := ipBytes[i] >> 4\n\t\tlowNibble := ipBytes[i] & 0x0F\n\n\t\t// Append the nibbles in reversed order\n\t\tsb.WriteString(fmt.Sprintf(\"%x.%x.\", lowNibble, highNibble))\n\t}\n\n\treturn sb.String()[:len(sb.String())-1]\n}\n\nfunc Lookup(ipStr string) (DroneBLResponse, error) {\n\tip := net.ParseIP(ipStr)\n\tif ip == nil {\n\t\treturn Unknown, errors.New(\"dnsbl: input is not an IP address\")\n\t}\n\n\trevIP := Reverse(ip) + \".dnsbl.dronebl.org\"\n\n\tips, err := net.LookupIP(revIP)\n\tif err != nil {\n\t\tvar dnserr *net.DNSError\n\t\tif errors.As(err, &dnserr) {\n\t\t\tif dnserr.IsNotFound {\n\t\t\t\treturn AllGood, nil\n\t\t\t}\n\t\t}\n\n\t\treturn Unknown, err\n\t}\n\n\tif len(ips) != 0 {\n\t\tfor _, ip := range ips {\n\t\t\treturn DroneBLResponse(ip.To4()[3]), nil\n\t\t}\n\t}\n\n\treturn UnknownSpambotOrDrone, nil\n}\n"
},
{
"path": "internal/dnsbl/dnsbl_test.go",
"content": "package dnsbl\n\nimport (\n\t\"fmt\"\n\t\"net\"\n\t\"os\"\n\t\"testing\"\n)\n\nfunc TestReverse4(t *testing.T) {\n\tcases := []struct {\n\t\tinp, out string\n\t}{\n\t\t{\"1.2.3.4\", \"4.3.2.1\"},\n\t}\n\n\tfor _, cs := range cases {\n\t\tt.Run(fmt.Sprintf(\"%s->%s\", cs.inp, cs.out), func(t *testing.T) {\n\t\t\tout := reverse4(net.ParseIP(cs.inp))\n\n\t\t\tif out != cs.out {\n\t\t\t\tt.Errorf(\"wanted %s\\ngot: %s\", cs.out, out)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestReverse6(t *testing.T) {\n\tcases := []struct {\n\t\tinp, out string\n\t}{\n\t\t{\n\t\t\tinp: \"1234:5678:9ABC:DEF0:1234:5678:9ABC:DEF0\",\n\t\t\tout: \"0.f.e.d.c.b.a.9.8.7.6.5.4.3.2.1.0.f.e.d.c.b.a.9.8.7.6.5.4.3.2.1\",\n\t\t},\n\t}\n\n\tfor _, cs := range cases {\n\t\tt.Run(fmt.Sprintf(\"%s->%s\", cs.inp, cs.out), func(t *testing.T) {\n\t\t\tout := reverse6(net.ParseIP(cs.inp))\n\n\t\t\tif out != cs.out {\n\t\t\t\tt.Errorf(\"wanted %s, got: %s\", cs.out, out)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestLookup(t *testing.T) {\n\tif os.Getenv(\"DONT_USE_NETWORK\") != \"\" {\n\t\tt.Skip(\"test requires network egress\")\n\t\treturn\n\t}\n\n\tresp, err := Lookup(\"27.65.243.194\")\n\tif err != nil {\n\t\tt.Fatalf(\"it broked: %v\", err)\n\t}\n\n\tt.Logf(\"response: %d\", resp)\n}\n"
},
{
"path": "internal/dnsbl/droneblresponse_string.go",
"content": "// Code generated by \"stringer -type=DroneBLResponse\"; DO NOT EDIT.\n\npackage dnsbl\n\nimport \"strconv\"\n\nfunc _() {\n\t// An \"invalid array index\" compiler error signifies that the constant values have changed.\n\t// Re-run the stringer command to generate them again.\n\tvar x [1]struct{}\n\t_ = x[AllGood-0]\n\t_ = x[IRCDrone-3]\n\t_ = x[Bottler-5]\n\t_ = x[UnknownSpambotOrDrone-6]\n\t_ = x[DDOSDrone-7]\n\t_ = x[SOCKSProxy-8]\n\t_ = x[HTTPProxy-9]\n\t_ = x[ProxyChain-10]\n\t_ = x[OpenProxy-11]\n\t_ = x[OpenDNSResolver-12]\n\t_ = x[BruteForceAttackers-13]\n\t_ = x[OpenWingateProxy-14]\n\t_ = x[CompromisedRouter-15]\n\t_ = x[AutoRootingWorms-16]\n\t_ = x[AutoDetectedBotIP-17]\n\t_ = x[Unknown-255]\n}\n\nconst (\n\t_DroneBLResponse_name_0 = \"AllGood\"\n\t_DroneBLResponse_name_1 = \"IRCDrone\"\n\t_DroneBLResponse_name_2 = \"BottlerUnknownSpambotOrDroneDDOSDroneSOCKSProxyHTTPProxyProxyChainOpenProxyOpenDNSResolverBruteForceAttackersOpenWingateProxyCompromisedRouterAutoRootingWormsAutoDetectedBotIP\"\n\t_DroneBLResponse_name_3 = \"Unknown\"\n)\n\nvar (\n\t_DroneBLResponse_index_2 = [...]uint8{0, 7, 28, 37, 47, 56, 66, 75, 90, 109, 125, 142, 158, 175}\n)\n\nfunc (i DroneBLResponse) String() string {\n\tswitch {\n\tcase i == 0:\n\t\treturn _DroneBLResponse_name_0\n\tcase i == 3:\n\t\treturn _DroneBLResponse_name_1\n\tcase 5 <= i && i <= 17:\n\t\ti -= 5\n\t\treturn _DroneBLResponse_name_2[_DroneBLResponse_index_2[i]:_DroneBLResponse_index_2[i+1]]\n\tcase i == 255:\n\t\treturn _DroneBLResponse_name_3\n\tdefault:\n\t\treturn \"DroneBLResponse(\" + strconv.FormatInt(int64(i), 10) + \")\"\n\t}\n}\n"
},
{
"path": "internal/glob/glob.go",
"content": "package glob\n\nimport \"strings\"\n\nconst GLOB = \"*\"\n\nconst maxGlobParts = 5\n\n// Glob will test a string pattern, potentially containing globs, against a\n// subject string. The result is a simple true/false, determining whether or\n// not the glob pattern matched the subject text.\nfunc Glob(pattern, subj string) bool {\n\t// Empty pattern can only match empty subject\n\tif pattern == \"\" {\n\t\treturn subj == pattern\n\t}\n\n\t// If the pattern _is_ a glob, it matches everything\n\tif pattern == GLOB {\n\t\treturn true\n\t}\n\n\tparts := strings.Split(pattern, GLOB)\n\n\tif len(parts) > maxGlobParts {\n\t\treturn false // Pattern is too complex, reject it.\n\t}\n\n\tif len(parts) == 1 {\n\t\t// No globs in pattern, so test for equality\n\t\treturn subj == pattern\n\t}\n\n\tleadingGlob := strings.HasPrefix(pattern, GLOB)\n\ttrailingGlob := strings.HasSuffix(pattern, GLOB)\n\tend := len(parts) - 1\n\n\t// Go over the leading parts and ensure they match.\n\tfor i := range end {\n\t\tidx := strings.Index(subj, parts[i])\n\n\t\tswitch i {\n\t\tcase 0:\n\t\t\t// Check the first section. Requires special handling.\n\t\t\tif !leadingGlob && idx != 0 {\n\t\t\t\treturn false\n\t\t\t}\n\t\tdefault:\n\t\t\t// Check that the middle parts match.\n\t\t\tif idx < 0 {\n\t\t\t\treturn false\n\t\t\t}\n\t\t}\n\n\t\t// Trim evaluated text from subj as we loop over the pattern.\n\t\tsubj = subj[idx+len(parts[i]):]\n\t}\n\n\t// Reached the last section. Requires special handling.\n\treturn trailingGlob || strings.HasSuffix(subj, parts[end])\n}\n"
},
{
"path": "internal/glob/glob_test.go",
"content": "package glob\n\nimport \"testing\"\n\nfunc TestGlob_EqualityAndEmpty(t *testing.T) {\n\tcases := []struct {\n\t\tname string\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"exact match\", \"hello\", \"hello\", true},\n\t\t{\"exact mismatch\", \"hello\", \"hell\", false},\n\t\t{\"empty pattern and subject\", \"\", \"\", true},\n\t\t{\"empty pattern with non-empty subject\", \"\", \"x\", false},\n\t\t{\"pattern star matches empty\", \"*\", \"\", true},\n\t\t{\"pattern star matches anything\", \"*\", \"anything at all\", true},\n\t}\n\tfor _, tc := range cases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\t\tt.Fatalf(\"Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestGlob_LeadingAndTrailing(t *testing.T) {\n\tcases := []struct {\n\t\tname string\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"prefix match - minimal\", \"foo*\", \"foo\", true},\n\t\t{\"prefix match - extended\", \"foo*\", \"foobar\", true},\n\t\t{\"prefix mismatch - not at start\", \"foo*\", \"xfoo\", false},\n\t\t{\"suffix match - minimal\", \"*foo\", \"foo\", true},\n\t\t{\"suffix match - extended\", \"*foo\", \"xfoo\", true},\n\t\t{\"suffix mismatch - not at end\", \"*foo\", \"foox\", false},\n\t\t{\"contains match\", \"*foo*\", \"barfoobaz\", true},\n\t\t{\"contains mismatch - missing needle\", \"*foo*\", \"f\", false},\n\t}\n\tfor _, tc := range cases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\t\tt.Fatalf(\"Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestGlob_MiddleAndOrder(t *testing.T) {\n\tcases := []struct {\n\t\tname string\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"middle wildcard basic\", \"f*o\", \"fo\", true},\n\t\t{\"middle wildcard gap\", \"f*o\", \"fZZZo\", true},\n\t\t{\"middle wildcard requires start f\", \"f*o\", \"xfyo\", false},\n\t\t{\"order enforced across parts\", \"a*b*c*d\", \"axxbxxcxxd\", true},\n\t\t{\"order mismatch fails\", \"a*b*c*d\", \"abdc\", false},\n\t\t{\"must end with last part when no trailing *\", \"*foo*bar\", \"zzfooqqbar\", true},\n\t\t{\"failing when trailing chars remain\", \"*foo*bar\", \"zzfooqqbarzz\", false},\n\t\t{\"first part must start when no leading *\", \"foo*bar\", \"zzfooqqbar\", false},\n\t\t{\"works with overlapping content\", \"ab*ba\", \"ababa\", true},\n\t\t{\"needle not found fails\", \"foo*bar\", \"foobaz\", false},\n\t}\n\tfor _, tc := range cases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\t\tt.Fatalf(\"Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestGlob_ConsecutiveStarsAndEmptyParts(t *testing.T) {\n\tcases := []struct {\n\t\tname string\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"double star matches anything\", \"**\", \"\", true},\n\t\t{\"double star matches anything non-empty\", \"**\", \"abc\", true},\n\t\t{\"consecutive stars behave like single\", \"a**b\", \"ab\", true},\n\t\t{\"consecutive stars with gaps\", \"a**b\", \"axxxb\", true},\n\t\t{\"consecutive stars + trailing star\", \"a**b*\", \"axxbzzz\", true},\n\t\t{\"consecutive stars still enforce anchors\", \"a**b\", \"xaBy\", false},\n\t}\n\tfor _, tc := range cases {\n\t\tt.Run(tc.name, func(t *testing.T) {\n\t\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\t\tt.Fatalf(\"Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t\t}\n\t\t})\n\t}\n}\n\nfunc TestGlob_MaxPartsLimit(t *testing.T) {\n\t// Allowed: up to 4 '*' (5 parts)\n\tallowed := []struct {\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"a*b*c*d*e\", \"axxbxxcxxdxxe\", true}, // 4 stars -> 5 parts\n\t\t{\"*a*b*c*d\", \"zzzaaaabbbcccddd\", true},\n\t\t{\"a*b*c*d*e\", \"abcde\", true},\n\t\t{\"a*b*c*d*e\", \"abxdxe\", false}, // missing 'c' should fail\n\t}\n\tfor _, tc := range allowed {\n\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\tt.Fatalf(\"allowed pattern Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t}\n\t}\n\n\t// Disallowed: 5 '*' (6 parts) -> always false by complexity check\n\tdisallowed := []struct {\n\t\tpattern string\n\t\tsubj string\n\t}{\n\t\t{\"a*b*c*d*e*f\", \"aXXbYYcZZdQQeRRf\"},\n\t\t{\"*a*b*c*d*e*\", \"abcdef\"},\n\t\t{\"******\", \"anything\"}, // 6 stars -> 7 parts\n\t}\n\tfor _, tc := range disallowed {\n\t\tif got := Glob(tc.pattern, tc.subj); got {\n\t\t\tt.Fatalf(\"disallowed pattern should fail Glob(%q,%q) = %v, want false\", tc.pattern, tc.subj, got)\n\t\t}\n\t}\n}\n\nfunc TestGlob_CaseSensitivity(t *testing.T) {\n\tcases := []struct {\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"FOO*\", \"foo\", false},\n\t\t{\"*Bar\", \"bar\", false},\n\t\t{\"Foo*Bar\", \"FooZZZBar\", true},\n\t}\n\tfor _, tc := range cases {\n\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\tt.Fatalf(\"Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t}\n\t}\n}\n\nfunc TestGlob_EmptySubjectInteractions(t *testing.T) {\n\tcases := []struct {\n\t\tpattern string\n\t\tsubj string\n\t\twant bool\n\t}{\n\t\t{\"*a\", \"\", false},\n\t\t{\"a*\", \"\", false},\n\t\t{\"**\", \"\", true},\n\t\t{\"*\", \"\", true},\n\t}\n\tfor _, tc := range cases {\n\t\tif got := Glob(tc.pattern, tc.subj); got != tc.want {\n\t\t\tt.Fatalf(\"Glob(%q,%q) = %v, want %v\", tc.pattern, tc.subj, got, tc.want)\n\t\t}\n\t}\n}\n\nfunc BenchmarkGlob(b *testing.B) {\n\tpatterns := []string{\n\t\t\"*\", \"*foo*\", \"foo*bar\", \"a*b*c*d*e\", \"a**b*\", \"*needle*end\",\n\t}\n\tsubjects := []string{\n\t\t\"\", \"foo\", \"barfoo\", \"foobarbaz\", \"axxbxxcxxdxxe\", \"zzfooqqbarzz\",\n\t\t\"lorem ipsum dolor sit amet, consectetur adipiscing elit\",\n\t}\n\tfor _, p := range patterns {\n\t\tfor _, s := range subjects {\n\t\t\tb.Run(p+\"::\"+s, func(b *testing.B) {\n\t\t\t\tfor i := 0; i < b.N; i++ {\n\t\t\t\t\t_ = Glob(p, s)\n\t\t\t\t}\n\t\t\t})\n\t\t}\n\t}\n}\n"
},
{
"path": "internal/gzip.go",
"content": "package internal\n\nimport (\n\t\"compress/gzip\"\n\t\"net/http\"\n\t\"strings\"\n)\n\nfunc GzipMiddleware(level int, next http.Handler) http.Handler {\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tif !strings.Contains(r.Header.Get(\"Accept-Encoding\"), \"gzip\") {\n\t\t\tnext.ServeHTTP(w, r)\n\t\t\treturn\n\t\t}\n\n\t\tw.Header().Set(\"Content-Encoding\", \"gzip\")\n\t\tgz, err := gzip.NewWriterLevel(w, level)\n\t\tif err != nil {\n\t\t\tpanic(err)\n\t\t}\n\t\tdefer gz.Close()\n\n\t\tgrw := gzipResponseWriter{ResponseWriter: w, sink: gz}\n\t\tnext.ServeHTTP(grw, r)\n\t})\n}\n\ntype gzipResponseWriter struct {\n\thttp.ResponseWriter\n\tsink *gzip.Writer\n}\n\nfunc (w gzipResponseWriter) Write(b []byte) (int, error) {\n\treturn w.sink.Write(b)\n}\n"
},
{
"path": "internal/hash.go",
"content": "package internal\n\nimport (\n\t\"crypto/sha256\"\n\t\"encoding/hex\"\n\t\"strconv\"\n\n\t\"github.com/cespare/xxhash/v2\"\n)\n\n// SHA256sum computes a cryptographic hash. Still used for proof-of-work challenges\n// where we need the security properties of a cryptographic hash function.\nfunc SHA256sum(text string) string {\n\thash := sha256.New()\n\thash.Write([]byte(text))\n\treturn hex.EncodeToString(hash.Sum(nil))\n}\n\n// FastHash is a high-performance non-cryptographic hash function suitable for\n// internal caching, policy rule identification, and other performance-critical\n// use cases where cryptographic security is not required.\nfunc FastHash(text string) string {\n\th := xxhash.Sum64String(text)\n\treturn strconv.FormatUint(h, 16)\n}\n"
},
{
"path": "internal/hash_bench_test.go",
"content": "package internal\n\nimport (\n\t\"fmt\"\n\t\"strings\"\n\t\"testing\"\n)\n\n// XXHash64sum is a test alias for FastHash to benchmark against SHA256\nfunc XXHash64sum(text string) string {\n\treturn FastHash(text)\n}\n\n// Test data that matches real usage patterns in the codebase\nvar (\n\t// Typical policy checker inputs\n\tpolicyInputs = []string{\n\t\t\"User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36\",\n\t\t\"User-Agent: bot/1.0\",\n\t\t\"User-Agent: GoogleBot/2.1\",\n\t\t\"/robots.txt\",\n\t\t\"/api/.*\",\n\t\t\"10.0.0.0/8\",\n\t\t\"192.168.1.0/24\",\n\t\t\"172.16.0.0/12\",\n\t}\n\n\t// Challenge data from challengeFor function\n\tchallengeInputs = []string{\n\t\t\"Accept-Language=en-US,X-Real-IP=192.168.1.100,User-Agent=Mozilla/5.0,WeekTime=2025-06-16T00:00:00Z,Fingerprint=abc123,Difficulty=5\",\n\t\t\"Accept-Language=fr-FR,X-Real-IP=10.0.0.50,User-Agent=Chrome/91.0,WeekTime=2025-06-16T00:00:00Z,Fingerprint=def456,Difficulty=3\",\n\t\t\"Accept-Language=es-ES,X-Real-IP=172.16.1.1,User-Agent=Safari/14.0,WeekTime=2025-06-16T00:00:00Z,Fingerprint=ghi789,Difficulty=7\",\n\t}\n\n\t// Bot rule patterns\n\tbotRuleInputs = []string{\n\t\t\"GoogleBot::path:/robots.txt\",\n\t\t\"BingBot::useragent:Mozilla/5.0 (compatible; bingbot/2.0)\",\n\t\t\"FacebookBot::headers:Accept-Language,User-Agent\",\n\t\t\"TwitterBot::cidr:192.168.1.0/24\",\n\t}\n\n\t// CEL expressions from policy rules\n\tcelInputs = []string{\n\t\t`request.headers[\"User-Agent\"].contains(\"bot\")`,\n\t\t`request.path.startsWith(\"/api/\") && request.method == \"POST\"`,\n\t\t`request.remoteAddress in [\"192.168.1.0/24\", \"10.0.0.0/8\"]`,\n\t\t`request.userAgent.matches(\".*[Bb]ot.*\") || request.userAgent.matches(\".*[Cc]rawler.*\")`,\n\t}\n\n\t// Thoth ASN checker inputs\n\tasnInputs = []string{\n\t\t\"ASNChecker\\nAS 15169\\nAS 8075\\nAS 32934\",\n\t\t\"ASNChecker\\nAS 13335\\nAS 16509\\nAS 14061\",\n\t\t\"ASNChecker\\nAS 36351\\nAS 20940\\nAS 8100\",\n\t}\n)\n\nfunc BenchmarkSHA256_PolicyInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := policyInputs[i%len(policyInputs)]\n\t\t_ = SHA256sum(input)\n\t}\n}\n\nfunc BenchmarkXXHash_PolicyInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := policyInputs[i%len(policyInputs)]\n\t\t_ = XXHash64sum(input)\n\t}\n}\n\nfunc BenchmarkSHA256_ChallengeInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := challengeInputs[i%len(challengeInputs)]\n\t\t_ = SHA256sum(input)\n\t}\n}\n\nfunc BenchmarkXXHash_ChallengeInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := challengeInputs[i%len(challengeInputs)]\n\t\t_ = XXHash64sum(input)\n\t}\n}\n\nfunc BenchmarkSHA256_BotRuleInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := botRuleInputs[i%len(botRuleInputs)]\n\t\t_ = SHA256sum(input)\n\t}\n}\n\nfunc BenchmarkXXHash_BotRuleInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := botRuleInputs[i%len(botRuleInputs)]\n\t\t_ = XXHash64sum(input)\n\t}\n}\n\nfunc BenchmarkSHA256_CELInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := celInputs[i%len(celInputs)]\n\t\t_ = SHA256sum(input)\n\t}\n}\n\nfunc BenchmarkXXHash_CELInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := celInputs[i%len(celInputs)]\n\t\t_ = XXHash64sum(input)\n\t}\n}\n\nfunc BenchmarkSHA256_ASNInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := asnInputs[i%len(asnInputs)]\n\t\t_ = SHA256sum(input)\n\t}\n}\n\nfunc BenchmarkXXHash_ASNInputs(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tinput := asnInputs[i%len(asnInputs)]\n\t\t_ = XXHash64sum(input)\n\t}\n}\n\n// Benchmark the policy list hashing used in checker.go\nfunc BenchmarkSHA256_PolicyList(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tvar sb strings.Builder\n\t\tfor _, input := range policyInputs {\n\t\t\tfmt.Fprintln(&sb, SHA256sum(input))\n\t\t}\n\t\t_ = SHA256sum(sb.String())\n\t}\n}\n\nfunc BenchmarkXXHash_PolicyList(b *testing.B) {\n\tb.ResetTimer()\n\tfor i := 0; i < b.N; i++ {\n\t\tvar sb strings.Builder\n\t\tfor _, input := range policyInputs {\n\t\t\tfmt.Fprintln(&sb, XXHash64sum(input))\n\t\t}\n\t\t_ = XXHash64sum(sb.String())\n\t}\n}\n\n// Tests that xxhash doesn't have collisions in realistic scenarios\nfunc TestHashCollisions(t *testing.T) {\n\tallInputs := append(append(append(append(policyInputs, challengeInputs...), botRuleInputs...), celInputs...), asnInputs...)\n\n\t// Start with realistic inputs from actual usage\n\txxhashHashes := make(map[string]string)\n\tfor _, input := range allInputs {\n\t\thash := XXHash64sum(input)\n\t\tif existing, exists := xxhashHashes[hash]; exists {\n\t\t\tt.Errorf(\"XXHash collision detected: %q and %q both hash to %s\", input, existing, hash)\n\t\t}\n\t\txxhashHashes[hash] = input\n\t}\n\n\tt.Logf(\"Basic test: %d realistic inputs, no collisions\", len(allInputs))\n\n\t// Test similar strings that might cause hash collisions\n\tprefixes := []string{\"User-Agent: \", \"X-Real-IP: \", \"Accept-Language: \", \"Host: \"}\n\tsuffixes := []string{\"bot\", \"crawler\", \"spider\", \"scraper\", \"Mozilla\", \"Chrome\", \"Safari\", \"Firefox\"}\n\tvariations := []string{\"\", \"/1.0\", \"/2.0\", \" (compatible)\", \" (Windows)\", \" (Linux)\", \" (Mac)\"}\n\n\tstressCount := 0\n\tfor _, prefix := range prefixes {\n\t\tfor _, suffix := range suffixes {\n\t\t\tfor _, variation := range variations {\n\t\t\t\tfor i := range 100 {\n\t\t\t\t\tinput := fmt.Sprintf(\"%s%s%s-%d\", prefix, suffix, variation, i)\n\t\t\t\t\thash := XXHash64sum(input)\n\t\t\t\t\tif existing, exists := xxhashHashes[hash]; exists {\n\t\t\t\t\t\tt.Errorf(\"XXHash collision in stress test: %q and %q both hash to %s\", input, existing, hash)\n\t\t\t\t\t}\n\t\t\t\t\txxhashHashes[hash] = input\n\t\t\t\t\tstressCount++\n\t\t\t\t}\n\t\t\t}\n\t\t}\n\t}\n\tt.Logf(\"Stress test 1: %d similar string variations, no collisions\", stressCount)\n\n\t// Test sequential patterns that might be problematic\n\tpatterns := []string{\n\t\t\"192.168.1.%d\",\n\t\t\"10.0.0.%d\",\n\t\t\"172.16.%d.1\",\n\t\t\"challenge-%d\",\n\t\t\"bot-rule-%d\",\n\t\t\"policy-%016x\",\n\t\t\"session-%016x\",\n\t}\n\n\tseqCount := 0\n\tfor _, pattern := range patterns {\n\t\tfor i := range 10000 {\n\t\t\tinput := fmt.Sprintf(pattern, i)\n\t\t\thash := XXHash64sum(input)\n\t\t\tif existing, exists := xxhashHashes[hash]; exists {\n\t\t\t\tt.Errorf(\"XXHash collision in sequential test: %q and %q both hash to %s\", input, existing, hash)\n\t\t\t}\n\t\t\txxhashHashes[hash] = input\n\t\t\tseqCount++\n\t\t}\n\t}\n\tt.Logf(\"Stress test 2: %d sequential patterns, no collisions\", seqCount)\n\n\ttotalInputs := len(allInputs) + stressCount + seqCount\n\tt.Logf(\"TOTAL: Tested %d inputs across realistic scenarios - NO COLLISIONS\", totalInputs)\n}\n\n// Verify xxhash output works as cache keys\nfunc TestXXHashFormat(t *testing.T) {\n\ttestCases := []string{\n\t\t\"short\",\n\t\t\"\",\n\t\t\"very long string with lots of content that might be used in policy checking and other internal hashing scenarios\",\n\t\t\"User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/91.0.4472.124 Safari/537.36\",\n\t}\n\n\tfor _, input := range testCases {\n\t\thash := XXHash64sum(input)\n\n\t\t// Check it's valid hex\n\t\tif len(hash) == 0 {\n\t\t\tt.Errorf(\"Empty hash for input %q\", input)\n\t\t}\n\n\t\t// xxhash is 64-bit so max 16 hex chars\n\t\tif len(hash) > 16 {\n\t\t\tt.Errorf(\"Hash too long for input %q: %s (length %d)\", input, hash, len(hash))\n\t\t}\n\n\t\t// Make sure it's all hex characters\n\t\tfor _, char := range hash {\n\t\t\tif !((char >= '0' && char <= '9') || (char >= 'a' && char <= 'f')) {\n\t\t\t\tt.Errorf(\"Non-hex character %c in hash %s for input %q\", char, hash, input)\n\t\t\t}\n\t\t}\n\n\t\tt.Logf(\"Input: %q -> Hash: %s\", input, hash)\n\t}\n}\n"
},
{
"path": "internal/headers.go",
"content": "package internal\n\nimport (\n\t\"context\"\n\t\"errors\"\n\t\"fmt\"\n\t\"log/slog\"\n\t\"net\"\n\t\"net/http\"\n\t\"net/netip\"\n\t\"strings\"\n\n\t\"github.com/TecharoHQ/anubis\"\n\t\"github.com/sebest/xff\"\n)\n\ntype realIPKey struct{}\n\nfunc RealIP(r *http.Request) (netip.Addr, bool) {\n\tresult, ok := r.Context().Value(realIPKey{}).(netip.Addr)\n\treturn result, ok\n}\n\n// TODO: move into config\ntype XFFComputePreferences struct {\n\tStripPrivate bool\n\tStripLoopback bool\n\tStripCGNAT bool\n\tStripLLU bool\n\tFlatten bool\n}\n\nvar CGNat = netip.MustParsePrefix(\"100.64.0.0/10\")\n\n// UnchangingCache sets the Cache-Control header to cache a response for 1 year if\n// and only if the application is compiled in \"release\" mode by Docker.\nfunc UnchangingCache(next http.Handler) http.Handler {\n\t//goland:noinspection GoBoolExpressions\n\tif anubis.Version == \"devel\" {\n\t\treturn next\n\t}\n\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tw.Header().Set(\"Cache-Control\", \"public, max-age=31536000\")\n\t\tnext.ServeHTTP(w, r)\n\t})\n}\n\n// CustomXRealIPHeader sets the X-Real-IP header to the value of a\n// different header.\n// Used in environments where the upstream proxy sets the request's\n// origin IP in a custom header.\nfunc CustomRealIPHeader(customRealIPHeaderValue string, next http.Handler) http.Handler {\n\tif customRealIPHeaderValue == \"\" {\n\t\tslog.Debug(\"skipping middleware, customRealIPHeaderValue is empty\")\n\t\treturn next\n\t}\n\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tr.Header.Set(\"X-Real-IP\", r.Header.Get(customRealIPHeaderValue))\n\t\tnext.ServeHTTP(w, r)\n\t})\n}\n\n// RemoteXRealIP sets the X-Real-Ip header to the request's real IP if\n// the setting is enabled by the user.\nfunc RemoteXRealIP(useRemoteAddress bool, bindNetwork string, next http.Handler) http.Handler {\n\tif !useRemoteAddress {\n\t\tslog.Debug(\"skipping middleware, useRemoteAddress is empty\")\n\t\treturn next\n\t}\n\n\tif bindNetwork == \"unix\" {\n\t\t// For local sockets there is no real remote address but the localhost\n\t\t// address should be sensible.\n\t\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\t\tr.Header.Set(\"X-Real-Ip\", \"127.0.0.1\")\n\t\t\tnext.ServeHTTP(w, r)\n\t\t})\n\t}\n\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\thost, _, err := net.SplitHostPort(r.RemoteAddr)\n\t\tif err != nil {\n\t\t\tpanic(err) // this should never happen\n\t\t}\n\t\tr.Header.Set(\"X-Real-Ip\", host)\n\t\tif addr, err := netip.ParseAddr(host); err == nil {\n\t\t\tr = r.WithContext(context.WithValue(r.Context(), realIPKey{}, addr))\n\t\t}\n\t\tnext.ServeHTTP(w, r)\n\t})\n}\n\n// XForwardedForToXRealIP sets the X-Real-Ip header based on the contents\n// of the X-Forwarded-For header.\nfunc XForwardedForToXRealIP(next http.Handler) http.Handler {\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tif xffHeader := r.Header.Get(\"X-Forwarded-For\"); r.Header.Get(\"X-Real-Ip\") == \"\" && xffHeader != \"\" {\n\t\t\tip := xff.Parse(xffHeader)\n\t\t\tslog.Debug(\"setting X-Real-Ip from X-Forwarded-For\", \"to\", ip, \"x-forwarded-for\", xffHeader)\n\t\t\tr.Header.Set(\"X-Real-Ip\", ip)\n\t\t\tif addr, err := netip.ParseAddr(ip); err == nil {\n\t\t\t\tr = r.WithContext(context.WithValue(r.Context(), realIPKey{}, addr))\n\t\t\t}\n\t\t}\n\n\t\tnext.ServeHTTP(w, r)\n\t})\n}\n\n// XForwardedForUpdate sets or updates the X-Forwarded-For header, adding\n// the known remote address to an existing chain if present\nfunc XForwardedForUpdate(stripPrivate bool, next http.Handler) http.Handler {\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tdefer next.ServeHTTP(w, r)\n\n\t\tpref := XFFComputePreferences{\n\t\t\tStripPrivate: stripPrivate,\n\t\t\tStripLoopback: true,\n\t\t\tStripCGNAT: true,\n\t\t\tFlatten: true,\n\t\t\tStripLLU: true,\n\t\t}\n\n\t\tremoteAddr := r.RemoteAddr\n\t\torigXFFHeader := r.Header.Get(\"X-Forwarded-For\")\n\n\t\tif remoteAddr == \"@\" {\n\t\t\t// remote is a unix socket\n\t\t\t// do not touch chain\n\t\t\treturn\n\t\t}\n\n\t\txffHeaderString, err := computeXFFHeader(remoteAddr, origXFFHeader, pref)\n\t\tif err != nil {\n\t\t\tslog.Debug(\"computing X-Forwarded-For header failed\", \"err\", err)\n\t\t\treturn\n\t\t}\n\n\t\tif len(xffHeaderString) == 0 {\n\t\t\tr.Header.Del(\"X-Forwarded-For\")\n\t\t} else {\n\t\t\tr.Header.Set(\"X-Forwarded-For\", xffHeaderString)\n\t\t}\n\t})\n}\n\nvar (\n\tErrCantSplitHostParse = errors.New(\"internal: unable to net.SplitHostParse\")\n\tErrCantParseRemoteIP = errors.New(\"internal: unable to parse remote IP\")\n)\n\nfunc computeXFFHeader(remoteAddr string, origXFFHeader string, pref XFFComputePreferences) (string, error) {\n\tremoteIP, _, err := net.SplitHostPort(remoteAddr)\n\tif err != nil {\n\t\treturn \"\", fmt.Errorf(\"%w: %w\", ErrCantSplitHostParse, err)\n\t}\n\tparsedRemoteIP, err := netip.ParseAddr(remoteIP)\n\tif err != nil {\n\t\treturn \"\", fmt.Errorf(\"%w: %w\", ErrCantParseRemoteIP, err)\n\t}\n\n\torigForwardedList := make([]string, 0, 4)\n\tif origXFFHeader != \"\" {\n\t\torigForwardedList = strings.Split(origXFFHeader, \",\")\n\t\tfor i := range origForwardedList {\n\t\t\torigForwardedList[i] = strings.TrimSpace(origForwardedList[i])\n\t\t}\n\t}\n\torigForwardedList = append(origForwardedList, parsedRemoteIP.String())\n\tforwardedList := make([]string, 0, len(origForwardedList))\n\t// this behavior is equivalent to\n\t// ingress-nginx \"compute-full-forwarded-for\"\n\t// https://kubernetes.github.io/ingress-nginx/user-guide/nginx-configuration/configmap/#compute-full-forwarded-for\n\t//\n\t// this would be the correct place to strip and/or flatten this list\n\t//\n\t// strip - iterate backwards and eliminate configured trusted IPs\n\t// flatten - only return the last element to avoid spoofing confusion\n\t//\n\t// many applications handle this in different ways, but\n\t// generally they'd be expected to do these two things on\n\t// their own end to find the first non-spoofed IP\n\tfor i := len(origForwardedList) - 1; i >= 0; i-- {\n\t\tsegmentIP, err := netip.ParseAddr(strings.TrimSpace(origForwardedList[i]))\n\t\tif err != nil {\n\t\t\t// can't assess this element, so the remainder of the chain\n\t\t\t// can't be trusted. not a fatal error, since anyone can\n\t\t\t// spoof an XFF header\n\t\t\tslog.Debug(\"failed to parse XFF segment\", \"err\", err)\n\t\t\tbreak\n\t\t}\n\t\tif pref.StripPrivate && segmentIP.IsPrivate() {\n\t\t\tcontinue\n\t\t}\n\t\tif pref.StripLoopback && segmentIP.IsLoopback() {\n\t\t\tcontinue\n\t\t}\n\t\tif pref.StripLLU && segmentIP.IsLinkLocalUnicast() {\n\t\t\tcontinue\n\t\t}\n\t\tif pref.StripCGNAT && CGNat.Contains(segmentIP) {\n\t\t\tcontinue\n\t\t}\n\t\tforwardedList = append([]string{segmentIP.String()}, forwardedList...)\n\t}\n\tvar xffHeaderString string\n\tif len(forwardedList) == 0 {\n\t\txffHeaderString = \"\"\n\t\treturn xffHeaderString, nil\n\t}\n\tif pref.Flatten {\n\t\txffHeaderString = forwardedList[len(forwardedList)-1]\n\t} else {\n\t\txffHeaderString = strings.Join(forwardedList, \",\")\n\t}\n\treturn xffHeaderString, nil\n}\n\n// NoStoreCache sets the Cache-Control header to no-store for the response.\nfunc NoStoreCache(next http.Handler) http.Handler {\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tw.Header().Set(\"Cache-Control\", \"no-store\")\n\t\tnext.ServeHTTP(w, r)\n\t})\n}\n\n// NoBrowsing prevents directory browsing by returning a 404 for any request that ends with a \"/\".\nfunc NoBrowsing(next http.Handler) http.Handler {\n\treturn http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {\n\t\tif strings.HasSuffix(r.URL.Path, \"/\") {\n\t\t\thttp.NotFound(w, r)\n\t\t\treturn\n\t\t}\n\t\tnext.ServeHTTP(w, r)\n\t})\n}\n"
},
{
"path": "internal/health.go",
"content": "package internal\n\nimport (\n\t\"context\"\n\n\t\"google.golang.org/grpc/health\"\n\thealthv1 \"google.golang.org/grpc/health/grpc_health_v1\"\n)\n\nvar HealthSrv = health.NewServer()\n\nfunc SetHealth(svc string, status healthv1.HealthCheckResponse_ServingStatus) {\n\tHealthSrv.SetServingStatus(svc, status)\n}\n\nfunc GetHealth(svc string) (healthv1.HealthCheckResponse_ServingStatus, bool) {\n\tst, err := HealthSrv.Check(context.Background(), &healthv1.HealthCheckRequest{\n\t\tService: svc,\n\t})\n\tif err != nil {\n\t\treturn healthv1.HealthCheckResponse_UNKNOWN, false\n\t}\n\n\treturn st.GetStatus(), true\n}\n"
},
{
"path": "internal/honeypot/honeypot.go",
"content": "package honeypot\n\nimport (\n\t\"time\"\n\n\t\"github.com/prometheus/client_golang/prometheus\"\n\t\"github.com/prometheus/client_golang/prometheus/promauto\"\n)\n\nvar Timings = promauto.NewHistogramVec(prometheus.HistogramOpts{\n\tNamespace: \"anubis\",\n\tSubsystem: \"honeypot\",\n\tName: \"pagegen_timings\",\n\tHelp: \"The amount of time honeypot page generation takes per method\",\n\tBuckets: prometheus.ExponentialBuckets(0.5, 2, 32),\n}, []string{\"method\"})\n\ntype Info struct {\n\tCreatedAt time.Time `json:\"createdAt\"`\n\tUserAgent string `json:\"userAgent\"`\n\tIPAddress string `json:\"ipAddress\"`\n\tHitCount int `json:\"hitCount\"`\n}\n"
},
{
"path": "internal/honeypot/naive/100bytes.css",
"content": "html {\n max-width: 70ch;\n padding: 3em 1em;\n margin: auto;\n line-height: 1.75;\n font-size: 1.25em;\n}\n"
},
{
"path": "internal/honeypot/naive/affirmations.txt",
"content": "{Yeah|Yep|Yup|Yes|Absolutely|Definitely|Sure|Sounds|That's|I'm|I am|Totally|Completely|Right|Correct|Exactly|Perfectly|Certainly|Of course|Naturally|Indeed|Awesome|Sweet|Cool|Neat|Great|Excellent|Fantastic|Wonderful|Amazing|Love it|Nice|Right on|You bet|For sure|No doubt|Without a doubt|Undoubtedly|Positively|Surely|Truly|Really|Genuinely|Honestly|Frankly|Literally|Precisely|Spot on|On point|Ideally|Optimally|Superbly|Brilliantly|Marvelously|Splendidly|Magnificently|Phenomenally|Extraordinarily|Remarkably|Exceptionally|Outstandingly|Impressively|Stunningly|Breathtakingly|Astonishingly|Surprisingly|Pleasantly|Delightfully|Charmingly|Appealingly|Attractively|Invitingly|Encouragingly|Motivatingly|Inspiringly|Upliftingly|Positive|Optimistic|Supportive|Approving|Favorable|Enthusiastic|Eager|Willing|Ready|Prepared|Set|Go|Let's|Alright|Okay|Sure thing|No problem|You got it|Consider it done|Will do|Roger that|Copy that|Got it|Understood|Acknowledged|Noted|Confirmed|Agreed|Approved|Accepted|Endorsed|Backed|Championed} {sounds|looks|seems|feels|is|appears|comes across|strikes me|hits me|registers|resonates|clicks|makes sense|fits|works|functions|operates|performs|delivers|succeeds|achieves|accomplishes|excels|shines|stands out|impresses|satisfies|meets expectations|exceeds expectations|delights|pleases|gratifies|fulfills|completes|finishes|concludes|wraps up|finalizes|settles|resolves|solves|fixes|addresses|handles|manages|tackles|conquers|overcomes|defeats|beats|wins|triumphs|prevails|dominates|leads|guides|directs|steers|navigates|paves the way|opens doors|creates opportunities|makes possible|enables|allows|permits|facilitates|drives|pushes|propels|launches|initiates|starts|begins|commences|kicks off|gets going|moves forward|progresses|advances|develops|evolves|grows|expands|improves|enhances|upgrades|optimizes|refines|perfects|polishes} {good|great|perfect|excellent|wonderful|fantastic|amazing|awesome|fine|okay|alright|nice|cool|spot on|reasonable|about right|superb|brilliant|marvelous|splendid|magnificent|phenomenal|extraordinary|remarkable|exceptional|outstanding|impressive|stunning|breathtaking|astonishing|surprising|pleasant|delightful|charming|appealing|attractive|inviting|positive|optimistic|supportive|approving|favorable|enthusiastic|eager|willing|ready|prepared|set|solid|strong|robust|powerful|effective|efficient|productive|successful|fruitful|beneficial|valuable|useful|helpful|advantageous|profitable|rewarding|satisfying|gratifying|fulfilling|complete|whole|total|entire|full|thorough|comprehensive|exhaustive|detailed|precise|accurate|correct|right|true|valid|sound|logical|rational|practical|realistic|feasible|possible|doable|achievable|attainable|obtainable|reachable|accessible|available|present|arranged|organized|structured|planned|scheduled|timed|well positioned|strategically located|ideally situated|well suited|well matched|compatible|harmonious|balanced|proportional|symmetrical|aesthetic|beautiful|gorgeous|lovely|pretty|handsome|striking|dramatic|bold|confident|assertive|decisive|clear|obvious|apparent|evident|manifest|plain|simple|easy|straightforward|uncomplicated|complex|intricate|nuanced|subtle|refined|elegant|sophisticated|advanced|progressive|innovative|creative|original|unique|special|distinctive|memorable|unforgettable|significant|important|major|key|critical|essential|vital|crucial|fundamental|basic|primary|principal|main|chief|leading|top|best|finest|ultimate|supreme|paramount|foremost|world class|professional|expert|master|skilled|talented|gifted|intelligent|smart|clever|wise|knowledgeable|informed|educated|learned|scholarly|theoretical|practical|applied|hands on|experienced|seasoned|veteran|mature|visionary|prophetic|intuitive|perceptive|insightful|sage|profound|deep|meaningful|substantial|considerable|influential|resilient|tough|durable|lasting|permanent|enduring|timeless|classic|traditional|conventional|standard|regular|normal|typical|usual|common|ordinary|average|fair|decent|respectable|acceptable|satisfactory|adequate|sufficient|enough|plentiful|abundant|ample|generous|rich|wealthy|prosperous|thriving|flourishing|blooming|superior|higher|elevated|modern|contemporary|current|fresh|novel|rare|uncommon|legendary|famous|well known|celebrated|accredited|honored|awarded|decorated|distinguished|illustrious|prestigious|reputable|admired|revered|beloved|cherished|treasured|prized|precious|close|intimate|personal|private|individual|priceless|worthwhile} {to me|for me|with me|I agree|I like it|let's do it|count me in|I'm on board|I'm in|I'm up for it|I'm down for that|I'm all for it|I'm good with that|I'm happy with that|I'm cool with that|let's go with that|let's make it happen|that works|that'll work|sounds like a plan|that's a good idea|that's a great choice|I think so too|my thoughts exactly|you read my mind|couldn't agree more|absolutely right|you nailed it|let's go|game on|challenge accepted|say no more|you had me at hello|I'm sold|sign me up|be there|definitely|for sure|sounds good|looks good|seems good|feels good|is good|let's do this|time to rock|let's roll|here we go|off we go|moving forward|full steam ahead|all systems go|green light|clear for takeoff|ready when you are|on your mark|get set|let's begin|commence operation|initiate protocol|execute plan|implement strategy|deploy solution|activate system|engage process|start procedure|begin sequence|launch project|kick off event|open doors|make way|clear path|pave way|create opportunity|make possible|enable success|facilitate growth|support development|encourage progress|inspire change|motivate action|drive results|push boundaries|break barriers|overcome challenges|solve problems|fix issues|address concerns|handle situations|manage difficulties|tackle obstacles|conquer fears|defeat doubts|win battles|triumph over adversity|prevail against odds|rise above|excel beyond|achieve greatness|reach heights|attain goals|accomplish dreams|realize potential|fulfill destiny|complete journey|finish race|cross finish line|arrive at destination|reach summit|climb mountain|sail seas|fly skies|explore worlds|discover truths|find answers|solve mysteries|uncover secrets|reveal wonders|share insights|spread joy|create happiness|build relationships|strengthen bonds|foster community|grow together|learn constantly|improve daily|evolve continuously|adapt quickly|change rapidly|transform completely|renew fully|refresh completely|restart anew|begin again|start fresh|clean slate|new chapter|fresh start|bright future|promising tomorrow|better days|good times|great moments|wonderful experiences|fantastic adventures|amazing journeys|awesome memories|precious moments|valuable lessons|helpful advice|useful tips|practical solutions|effective strategies|successful methods|proven approaches|tested techniques|reliable systems|dependable support|consistent performance|steady progress|continuous improvement|ongoing development|perpetual growth|endless possibilities|unlimited potential|infinite opportunities|boundless horizons|vast expanses|wide ranges|broad spectrums|diverse options|multiple choices|various paths|different routes|alternative ways|other methods|additional approaches|extra techniques|supplementary tools|auxiliary resources|backup plans|contingency options|emergency measures|safety nets|security blankets|comfort zones|safe spaces|peaceful havens|tranquil sanctuaries|serene environments|calm atmospheres|relaxed vibes|easy feelings|comfortable sensations|pleasant experiences|enjoyable moments|delightful times|charming encounters|appealing situations|attractive prospects|inviting opportunities|encouraging signs|motivating factors|inspiring elements|uplifting aspects|positive features|optimistic views|encouraging outlooks|supportive attitudes|approving perspectives|favorable opinions|enthusiastic responses|eager reactions|willing participants|ready volunteers|prepared individuals|set teams|organized groups|structured units|planned initiatives|scheduled events|timed activities|well positioned assets|strategically located resources|ideally situated elements|perfectly suited components|well matched partners|compatible collaborations|harmonious relationships|balanced arrangements|proportional distributions|symmetrical designs|aesthetic presentations|beautiful displays|gorgeous exhibitions|lovely shows|pretty sights|attractive views|striking scenes|dramatic performances|bold statements|confident expressions|decisive actions|clear communications|obvious demonstrations|apparent revelations|evident truths|manifest realities|plain facts|simple solutions|easy implementations|straightforward processes|uncomplicated procedures|complex systems|intricate networks|detailed analyses|nuanced discussions|subtle distinctions|refined approaches|elegant solutions|sophisticated methods|advanced technologies|progressive ideas|innovative concepts|creative designs|original works|unique creations|special projects|distinctive features|memorable experiences|unforgettable moments|legendary achievements|famous accomplishments|well recognized contributions|acknowledged impacts|celebrated successes|acclaimed performances|honored achievements|awarded excellence|decorated heroes|distinguished leaders|illustrious careers|prestigious positions|reputable organizations|respected institutions|admired figures|revered icons|beloved personalities|cherished treasures|valued possessions|prized collections|precious artifacts|dear friends|close companions|intimate partners|personal connections|individual expressions|unique perspectives|special talents|one of a kind gifts|irreplaceable values|invaluable insights|priceless wisdom|worthwhile endeavors|valuable investments|useful tools|beneficial resources|helpful services|advantageous positions|profitable ventures|rewarding careers|satisfying lives|gratifying experiences|fulfilling purposes|complete beings|whole persons|total entities|entire systems|full cycles|perfect circles|ideal forms|ultimate goals|best practices|finest qualities|supreme achievements|excellent results|outstanding performances|superior outcomes|exceptional contributions|remarkable discoveries|extraordinary breakthroughs|special recognitions|unique innovations|distinctive designs|memorable impacts|impressive feats|dramatic transformations|powerful changes|strong foundations|effective actions|efficient operations|successful missions|productive endeavors|fruitful partnerships|beneficial collaborations|valuable connections|helpful networks|worthwhile projects|rewarding adventures|satisfying journeys|gratifying accomplishments|fulfilling destinies}{|!|, let's go!|, amazing!|, fantastic!|, wonderful!|, perfect!|, brilliant!|, excellent!|, outstanding!|, superb!|, great!|, nice!|, cool!|, sweet!|, awesome!|, love it!|, beautiful!|, gorgeous!|, stunning!|, breathtaking!|, phenomenal!|, extraordinary!|, remarkable!|, exceptional!|, impressive!|, striking!|, dramatic!|, powerful!|, magnificent!|, splendid!|, marvelous!|, terrific!|, superb!|, divine!|, heavenly!|, celestial!|, transcendent!|, sublime!|, perfect!|, flawless!|, impeccable!|, ideal!|, ultimate!|, supreme!|, paramount!|, unbeatable!|, unstoppable!|, incredible!|, unbelievable!|, astounding!|, mind-blowing!|, jaw-dropping!|, spectacular!|, epic!|, legendary!|, iconic!|, classic!|, timeless!|, eternal!|, infinite!|, boundless!|, limitless!|, endless!|, forever!|, always!|, never-ending!|, perpetual!|, constant!|, steady!|, solid!|, rock-solid!|, unshakeable!|, unbreakable!|, invincible!|, indestructible!|, immortal!|, everlasting!|, undying!|, living!|, vibrant!|, dynamic!|, energetic!|, lively!|, spirited!|, enthusiastic!|, passionate!|, fervent!|, zealous!|, dedicated!|, committed!|, devoted!|, loyal!|, faithful!|, true!|, real!|, authentic!|, genuine!|, legit!|, certified!|, proven!|, tested!|, verified!|, confirmed!|, validated!|, approved!|, endorsed!|, supported!|, backed!|, guaranteed!|, assured!|, certain!|, sure!|, positive!|, confident!|, secure!|, safe!|, protected!|, covered!|, sheltered!|, guarded!|, watched over!|, cared for!|, nurtured!|, cherished!|, treasured!|, valued!|, respected!|, admired!|, appreciated!|, recognized!|, acknowledged!|, celebrated!|, honored!|, praised!|, applauded!|, cheered!|, supported!|, embraced!|, welcomed!|, accepted!|, included!|, belonging!|, connected!|, united!|, joined!|, together!|, as one!|, in harmony!|, in sync!|, aligned!|, balanced!|, centered!|, grounded!|, rooted!|, established!|, settled!|, calm!|, peaceful!|, serene!|, tranquil!|, quiet!|, still!|, at ease!|, comfortable!|, relaxed!|, content!|, happy!|, joyful!|, delighted!|, thrilled!|, excited!|, elated!|, ecstatic!|, overjoyed!|, euphoric!|, blissful!|, radiant!|, glowing!|, shining!|, sparkling!|, dazzling!|, brilliant!|, bright!|, luminous!|, illuminated!|, enlightened!|, inspired!|, uplifted!|, elevated!|, empowered!|, strengthened!|, fortified!|, revitalized!|, renewed!|, refreshed!|, recharged!|, energized!|, activated!|, awakened!|, alive!|, thriving!|, flourishing!|, blooming!|, growing!|, expanding!|, developing!|, evolving!|, transforming!|, becoming!|, emerging!|, rising!|, ascending!|, climbing!|, reaching!|, achieving!|, succeeding!|, winning!|, triumphing!|, conquering!|, overcoming!|, mastering!|, perfecting!|, completing!|, fulfilling!|, realizing!|, manifesting!|, creating!|, building!|, making!|, doing!|, being!|, living!|, breathing!|, existing!|, present!|, here!|, now!|, always!|, forever!|, eternally!}"
},
{
"path": "internal/honeypot/naive/naive.go",
"content": "package naive\n\nimport (\n\t\"context\"\n\t_ \"embed\"\n\t\"fmt\"\n\t\"log/slog\"\n\t\"math/rand/v2\"\n\t\"net/http\"\n\t\"net/netip\"\n\t\"time\"\n\n\t\"github.com/TecharoHQ/anubis/internal\"\n\t\"github.com/TecharoHQ/anubis/internal/honeypot\"\n\t\"github.com/TecharoHQ/anubis/lib/policy/checker\"\n\t\"github.com/TecharoHQ/anubis/lib/store\"\n\t\"github.com/a-h/templ\"\n\t\"github.com/google/uuid\"\n\t\"github.com/nikandfor/spintax\"\n)\n\n//go:generate go tool github.com/a-h/templ/cmd/templ generate\n\n// XXX(Xe): All of this was generated by ChatGPT, GLM 4.6, and GPT-OSS 120b. This is pseudoprofound bullshit in spintax[1] format so that the bullshit generator can emit plausibly human-authored text while being very computationally cheap.\n//\n// It feels somewhat poetic to use spammer technology in Anubis.\n//\n// [1]: https://outboundly.ai/blogs/what-is-spintax-and-how-to-use-it/\n//\n//go:embed spintext.txt\nvar spintext string\n\n//go:embed titles.txt\nvar titles string\n\n//go:embed affirmations.txt\nvar affirmations string\n\nfunc New(st store.Interface, lg *slog.Logger) (*Impl, error) {\n\taffirmation, err := spintax.Parse(affirmations)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"can't parse affirmations: %w\", err)\n\t}\n\n\tbody, err := spintax.Parse(spintext)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"can't parse bodies: %w\", err)\n\t}\n\n\ttitle, err := spintax.Parse(titles)\n\tif err != nil {\n\t\treturn nil, fmt.Errorf(\"can't parse titles: %w\", err)\n\t}\n\n\tlg.Debug(\"initialized basic bullshit generator\", \"affirmations\", affirmation.Count(), \"bodies\", body.Count(), \"titles\", title.Count())\n\n\treturn &Impl{\n\t\tst: st,\n\t\tinfos: store.JSON[honeypot.Info]{Underlying: st, Prefix: \"honeypot:info\"},\n\t\tuaWeight: store.JSON[int]{Underlying: st, Prefix: \"honeypot:user-agent\"},\n\t\tnetworkWeight: store.JSON[int]{Underlying: st, Prefix: \"honeypot:network\"},\n\t\taffirmation: affirmation,\n\t\tbody: body,\n\t\ttitle: title,\n\t\tlg: lg.With(\"component\", \"honeypot/naive\"),\n\t}, nil\n}\n\ntype Impl struct {\n\tst store.Interface\n\tinfos store.JSON[honeypot.Info]\n\tuaWeight store.JSON[int]\n\tnetworkWeight store.JSON[int]\n\tlg *slog.Logger\n\n\taffirmation, body, title spintax.Spintax\n}\n\nfunc (i *Impl) incrementUA(ctx context.Context, userAgent string) int {\n\tresult, _ := i.uaWeight.Get(ctx, internal.SHA256sum(userAgent))\n\tresult++\n\ti.uaWeight.Set(ctx, internal.SHA256sum(userAgent), result, time.Hour)\n\treturn result\n}\n\nfunc (i *Impl) incrementNetwork(ctx context.Context, network string) int {\n\tresult, _ := i.networkWeight.Get(ctx, internal.SHA256sum(network))\n\tresult++\n\ti.networkWeight.Set(ctx, internal.SHA256sum(network), result, time.Hour)\n\treturn result\n}\n\nfunc (i *Impl) CheckUA() checker.Impl {\n\treturn checker.Func(func(r *http.Request) (bool, error) {\n\t\tresult, _ := i.uaWeight.Get(r.Context(), internal.SHA256sum(r.UserAgent()))\n\t\tif result >= 25 {\n\t\t\treturn true, nil\n\t\t}\n\n\t\treturn false, nil\n\t})\n}\n\nfunc (i *Impl) CheckNetwork() checker.Impl {\n\treturn checker.Func(func(r *http.Request) (bool, error) {\n\t\tresult, _ := i.uaWeight.Get(r.Context(), internal.SHA256sum(r.UserAgent()))\n\t\tif result >= 25 {\n\t\t\treturn true, nil\n\t\t}\n\n\t\treturn false, nil\n\t})\n}\n\nfunc (i *Impl) Hash() string {\n\treturn internal.SHA256sum(\"naive honeypot\")\n}\n\nfunc (i *Impl) makeAffirmations() []string {\n\tcount := rand.IntN(5) + 1\n\n\tvar result []string\n\tfor range count {\n\t\tresult = append(result, i.affirmation.Spin())\n\t}\n\n\treturn result\n}\n\nfunc (i *Impl) makeSpins() []string {\n\tcount := rand.IntN(5) + 1\n\n\tvar result []string\n\tfor range count {\n\t\tresult = append(result, i.body.Spin())\n\t}\n\n\treturn result\n}\n\nfunc (i *Impl) makeTitle() string {\n\treturn i.title.Spin()\n}\n\nfunc (i *Impl) ServeHTTP(w http.ResponseWriter, r *http.Request) {\n\tt0 := time.Now()\n\tlg := internal.GetRequestLogger(i.lg, r)\n\n\tid := r.PathValue(\"id\")\n\tif id == \"\" {\n\t\tid = uuid.NewString()\n\t}\n\n\trealIP, _ := internal.RealIP(r)\n\tif !realIP.IsValid() {\n\t\trealIP = netip.MustParseAddr(r.Header.Get(\"X-Real-Ip\"))\n\t}\n\n\tnetwork, ok := internal.ClampIP(realIP)\n\tif !ok {\n\t\tlg.Error(\"clampIP failed\", \"output\", network, \"ok\", ok)\n\t\thttp.Error(w, \"The cake is a lie\", http.StatusTeapot)\n\t\treturn\n\t}\n\n\tnetworkCount := i.incrementNetwork(r.Context(), network.String())\n\tuaCount := i.incrementUA(r.Context(), r.UserAgent())\n\n\tstage := r.PathValue(\"stage\")\n\n\tif stage == \"init\" {\n\t\tlg.Debug(\"found new entrance point\", \"id\", id, \"stage\", stage, \"userAgent\", r.UserAgent(), \"clampedIP\", network)\n\t} else {\n\t\tswitch {\n\t\tcase networkCount%256 == 0, uaCount%256 == 0:\n\t\t\tlg.Warn(\"found possible crawler\", \"id\", id, \"network\", network)\n\t\t}\n\t}\n\n\tspins := i.makeSpins()\n\taffirmations := i.makeAffirmations()\n\ttitle := i.makeTitle()\n\n\tvar links []link\n\tfor _, affirmation := range affirmations {\n\t\tlinks = append(links, link{\n\t\t\thref: uuid.NewString(),\n\t\t\tbody: affirmation,\n\t\t})\n\t}\n\n\ttempl.Handler(\n\t\tbase(title, i.maze(spins, links)),\n\t\ttempl.WithStreaming(),\n\t\ttempl.WithStatus(http.StatusOK),\n\t).ServeHTTP(w, r)\n\n\tt1 := time.Since(t0)\n\thoneypot.Timings.WithLabelValues(\"naive\").Observe(float64(t1.Milliseconds()))\n}\n\ntype link struct {\n\thref string\n\tbody string\n}\n"
},
{
"path": "internal/honeypot/naive/page.templ",
"content": "package naive\n\nimport \"fmt\"\n\ntempl base(title string, body templ.Component) {\n\t<!DOCTYPE html>\n\t<html>\n\t\t<head>\n\t\t\t<style>\n html {\n max-width: 70ch;\n padding: 3em 1em;\n margin: auto;\n line-height: 1.75;\n font-size: 1.25em;\n }\n </style>\n\t\t\t<title>{ title } \n\t\t\n\t\t\n\t\t\t{ title } \n\t\t\t@body\n\t\t\n\t ![\"A](\"./web/static/img/happy.webp\")
\n![\"Raptor](\"./docs/static/img/sponsors/raptor-computing-logo.webp\"){kind=logo}
\n\n\n ![\"Databento\"](\"./docs/static/img/sponsors/databento-logo.webp\"){kind=logo}
\n\n\n### Gold Tier\n\n\n ![\"Unipromos\"](\"./docs/static/img/sponsors/unipromos.webp\")
\n\n\n ![\"Uvensys\"](\"./docs/static/img/sponsors/uvensys.webp\")
\n\n\n ![\"Distrust\"](\"./docs/static/img/sponsors/distrust-logo.webp\"){kind=logo}
\n\n\n ![\"Gitea\"](\"./docs/static/img/sponsors/gitea-logo.webp\"){kind=logo}
\n\n\n ![\"Prolocation\"](\"./docs/static/img/sponsors/prolocation-logo.svg\"){kind=logo}
\n\n\n ![\"Terminal](\"./docs/static/img/sponsors/terminal-trove.webp\")
\n\n\n ![\"canine.tools\"](\"./docs/static/img/sponsors/caninetools-logo.webp\"){kind=logo}
\n\n\n ![\"Weblate\"](\"./docs/static/img/sponsors/weblate-logo.webp\"){kind=logo}
\n\n\n ![\"Uberspace\"](\"./docs/static/img/sponsors/uberspace-logo.webp\"){kind=logo}
\n\n\n ![\"Wildbase\"](\"./docs/static/img/sponsors/wildbase-logo.webp\"){kind=logo}
\n\n\n ![\"ANEXIA](\"./docs/static/img/sponsors/anexia-cloudsolutions-logo.webp\"){kind=logo}
\n\n\n## Overview\n\nAnubis is a Web AI Firewall Utility that [weighs the soul of your connection](https://en.wikipedia.org/wiki/Weighing_of_souls) using one or more challenges in order to protect upstream resources from scraper bots.\n\nThis program is designed to help protect the small internet from the endless storm of requests that flood in from AI companies. Anubis is as lightweight as possible to ensure that everyone can afford to protect the communities closest to them.\n\nAnubis is a bit of a nuclear response. This will result in your website being blocked from smaller scrapers and may inhibit \"good bots\" like the Internet Archive. You can configure [bot policy definitions](./docs/docs/admin/policies.mdx) to explicitly allowlist them and we are working on a curated set of \"known good\" bots to allow for a compromise between discoverability and uptime.\n\nIn most cases, you should not need this and can probably get by using Cloudflare to protect a given origin. However, for circumstances where you can't or won't use Cloudflare, Anubis is there for you.\n\nIf you want to try this out, visit the Anubis documentation site at [anubis.techaro.lol](https://anubis.techaro.lol).\n\n## Support\n\nIf you run into any issues running Anubis, please [open an issue](https://github.com/TecharoHQ/anubis/issues/new?template=Blank+issue). Please include all the information I would need to diagnose your issue.\n\nFor live chat, please join the [Patreon](https://patreon.com/cadey) and ask in the Patron discord in the channel `#anubis`.\n\n## Star History\n\n\n