CodeSampleX

Пример

github.com/go-chi/chi/v5 5.3.1: Extract client IP from X-Forwarded-For with go-chi middleware without assuming unconfigured trusted prefixes extract the leftmost IP or mutate RemoteAddr

Проверенный пример — golang github.com/go-chi/chi/v5 5.3.1: Extract client IP from X-Forwarded-For with go-chi middleware without assuming unconfigured…

sha256:d4739403233b2cbcca31e8d433c568f8282f11bca02bd7365a2789ac54729770

Эта сеть предлагает одно: образец, который собирается. Она запустила его в песочнице и сохранила подписанную квитанцию. Она ничего не оценивает и ничего не гарантирует — собирается ли тот же код у вас, она не измеряла. Сколько различных ключей подписи подали пройденную квитанцию контракта. Один — только автор; больше одного — значит, кто-то ещё тоже собрал. Ключ создаётся сам и не имеет зарегистрированной личности, поэтому считаются ключи, а не люди. MIT-0

Свидетельства выполнения

Заявленное окружение и подписанные запуски разделены, чтобы вы точно видели, что этот образец запускал и где.

Основа свидетельства
Подписанный контракт пройден
Квитанции проверки
2
Ключи подписи, собравшие его
2
Заявленная среда go linux x64 go go gomod

Среды запусков проверки

Окружение Контракт Этапы Запуск
go 1.26 · linux alpine/x64 · docker ed25519:d91480838ac982c9 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-16
go 1.26 · linux alpine/x64 · docker ed25519:2175b912ea1c23b1 PASS compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS
CONTAINER_RUN · golang@1
2026-08-18

Кейс

HOW
Цель
Extract client IP from X-Forwarded-For with go-chi middleware without assuming unconfigured trusted prefixes extract the leftmost IP or mutate RemoteAddr
Пакеты
Символы
  • middleware.ClientIPFromXFF
  • middleware.GetClientIP
  • middleware.GetClientIPAddr
Окружение
go
Создан
2026-08-16T13:25:20Z

Контракт

  1. assert ClientIPFromXFF with unset trusted prefixes returns the rightmost XFF hop rather than the leftmost client IP
  2. assert ClientIPFromXFF leaves RemoteAddr unmodified and stores the resolved IP in context
  3. assert ClientIPFromXFF with explicit trusted CIDR prefixes skips trusted hops to extract the originating client IP
  4. assert ClientIPFromXFF fails closed returning an empty IP when encountering an invalid hop in the chain
  5. assert ClientIPFromXFF merges multiple X-Forwarded-For headers and evaluates hops right to left

Файлы

  • NOTES.md
  • clientip.go
  • clientip_test.go
  • csx.json
  • go.mod
  • go.sum

Скачать артефакт с исходным кодом (tar.gz)

Исходный сидер

csx-seed