Русскоязычное описание ниже (Russian below).
Home page: https://github.com/rekby/lets-proxy2
Features:
- Domain names for certificates get from request by SNI
- http-01 and tls-alpn-01 validation
- HTTPS (with certificate autoissue) and HTTP reverse proxy
- Zero config for start usage
- Time limit for issue certificate
- Auto include subdomains in certificate (default: domain and www.domain)
- Logging for stderr and/or file
- Self rotate log files (can disable by config)
- Can configure backend in dependence of incoming connection IP:Port
- Custom headers to backend
- Self check domain before issue cert (prevent DoS cert issue attack by requests with bad domains)
- Blacklist/whitelist of domains
- Lock certificates (force to use manual issued certificate without internal checks)
- Optional access to internal metrics with Prometheus format
It is next generation of https://github.com/rekby/lets-proxy, rewrited from scratch.
It is improove logging and internal structure for better test coverage and simpler support. Add config support instead of many command line flags.
A reverse-proxy server to handle https requests transparently. By default Lets-proxy handles https requests to port 443 and proxies them as http to port 80 on the same IP address.
Lets-proxy adds the http headers, X-Forwarded-For
which contains the IP address.
It obtains valid TLS certificates from Let's Encrypt and handles https for free, in an automated way,
including certificate renewal, and without warning in browsers. It needs only for domain be true public domain and has A/AAAA record to public available IP address.
The program was created for shared hosting and can handle many thousands of domains per server. It is simple to implement and doesn't need settings to start the program on personal server/vps.
Quick start:
./lets-proxy or lets-proxy.exe
Use --help key for details:
./lets-proxy --help or lets-proxy.exe --help
Сайт программы: https://github.com/rekby/lets-proxy2
Возможности:
- Доменные имена для выпуска сертификатов получаются из SNI, их не нужно настраивать.
- Авторизация доменов по протоколам http-01 and tls-alpn-01
- Проксирование HTTPS (с автовыпуском сертификата) and HTTP
- Начать использование можно без настроек
- Ограничение времени на получение сертификата
- Автоматическое получение сертификата для домена и поддоменов (default: domain and www.domain)
- Вывод логов в файл и/или на стандартный вывод ошибок
- Самостоятельная ротация лог-файлов (отключается в настройках)
- Можно настроить адрес перенаправления запроса в заивисмости от адреса приема запроса.
- Настраиваемые дополнительные заголовки для передачи на внутренний сервер
- Самостоятельная проверка возможности выпуска сертификата перед его запросом (для исключения DoS-атак путем запросов с неправильными доменами)
- Белый/чёрный списки доменов для выпуска сертификатов
- Фиксированный сертификат (возможность использовать самостоятельно полученный сертификат, без внутренних проверок и автообновления)
- Опциональный доступ к внутренним метрикам в формате Prometheus
Эта программа - следующая итерация после https://github.com/rekby/lets-proxy, переписанная с нуля.
Улучшено логирование, внутреннее устройство кода - для упрощения тестирования и поддержки/развития. Добавлена поддержка файла настроек вместо огромного списка флагов.
Реверс-прокси сервер для прозрачной обработки https-запросов. Для начала использования достаточно просто запустить его на сервере с
запущенным http-сервером. При этом lets-proxy начнёт слушать порт 433 и передавать запросы на порт 80 с тем же IP-адресом.
К запросу будет добавляться заголовок X-Forwarded-For
с IP-адресом источника запроса.
Сертификаты для работы https получаются в реальном времени от letsencrypt.org. Это правильные
(не самоподписанные) бесплатные сертификаты, которым доверяют браузеры. Нужно только чтобы домен был общедоступен и указывал на общедоступный IP-адрес.
Программа разрабатывается для использования на виртуальном хостинге и может работать с тысячами доменов на каждом сервере. С другой стороны она проста и не требует начальных настроек для запуска на персональном сервере.
Быстрый старт:
./lets-proxy или lets-proxy.exe
- https://github.com/gojuno/minimock - for tests
- https://github.com/kardianos/minwinsvc - for run as windows service
- https://github.com/maxatome/go-testdeep - for tests
- https://github.com/mitchellh/gox - for multiply binaries build
- https://github.com/pelletier/go-toml - for config file.
- https://github.com/rekby/zapcontext - for pass logger to/from context
- https://github.com/satori/go.uuid - for generate uuid
- http://go.uber.org/zap - for logging
- http://golang.org/x/crypto - use acme part - for access for lets encrypt server.
- http://golang.org/x/net - use idna part for log domain names
- http://gopkg.in/natefinch/lumberjack.v2 - use for self log rotation.