Как работает clx
clx ставит в ваш аккаунт Cloudflare один воркер. Он считает посещения и обслуживает короткие ссылки на ваших доменах, хранит подробности в вашей базе D1, а на clx.cx отправляет только итоги.
- 1Подключите Cloudflare
- 2Добавьте сайт или хост ссылок
- 3Смотрите отчёт
Посетитель
открывает страницу вашего сайта или короткую ссылку на вашем домене
clx-edge в вашем аккаунте
считает просмотр или переадресует клик, пишет подробности в вашу D1
clx.cx
раз в час получает итоги и читает вашу D1, когда вы открываете отчёт
Токен только с нужными правами
Вы создаёте суточный bootstrap-токен по ссылке-шаблону. clx делает из него рабочий токен для одного этого аккаунта на год и удаляет bootstrap-токен — или просит отозвать его вручную, если Cloudflare не дал. Рабочий токен хранится зашифрованным, и в нём только эти права:
- Скрипты и маршруты Workers — поставить воркер и его маршруты
- D1 — база воркера
- Чтение зон — из каких доменов выбирать
- Чтение настроек и аналитики аккаунта — его название и предупреждение, пока квота не кончилась
clx создаёт только своё
Один воркер и одну базу, обе с именем clx-edge, и маршрут для каждого сайта и для хоста ссылок. clx записывает, что создал. Если clx-edge, созданный не им, уже есть — он останавливается и ничего не трогает; прежде чем заменить или удалить воркер, проверяет, что там код его же выпуска.
Где лежат ваши данные
Подробности — страницы, источники, страны, устройства, браузеры, системы — остаются в базе D1 вашего аккаунта: по часам 31 день, по дням 400 дней. На clx.cx хранятся ваши настройки и итоги. Посетитель считается по хешу с суточной солью; хеш и соль удаляются, когда сутки закрываются, и не покидают ваш аккаунт.
Обновления и как уйти
clx обновляет воркер одним проверенным выпуском для всех аккаунтов, сначала обновляя схему его базы. Отключение удаляет воркер, базу и маршруты и перечисляет, что удалить не удалось; рабочий токен вы отзываете в Cloudflare по ссылке от clx, а итоги на clx.cx удаляются через 30 дней или сразу. Один отзыв токена не даёт clx ничего менять; удалите clx-edge сами — и подсчёт и ссылки остановятся сразу.