Кеш — это не ошибка браузера
Браузеры и промежуточные кеши могут сохранять ответы, чтобы следующие загрузки были быстрее и экономнее. Пока сохранённый ресурс считается свежим, браузер вправе использовать его, не отправляя новый запрос. Поэтому обновление файла на сервере не всегда означает немедленное обновление страницы у каждого посетителя.
Причину обычно можно найти в заголовках HTTP — через вкладку Network в DevTools либо командой curl -I.
Свежесть и повторная проверка
Cache-Control: max-age=3600 позволяет считать ответ свежим до одного часа. no-cache не запрещает хранение: он требует проверить актуальность перед повторным использованием. no-store указывает кешам не сохранять ответ.
Для проверки браузер может передать If-None-Match со значением ранее полученного ETag. Если содержимое не изменилось, сервер может ответить 304 Not Modified без повторной передачи файла.
Версионирование CSS и JavaScript
Надёжный подход — менять URL при изменении CSS или JS. Особенно удобны имена с хешем содержимого, например main.a43f2.css. Такие ресурсы можно долго кешировать, а обновлённый HTML будет указывать на новые имена файлов.
Для небольшого сайта иногда достаточно параметра версии: /assets/styles.css?v=3. Это создаёт новый URL, хотя конкретное поведение всё равно зависит от настроек кеширования.
Если HTML обновился, а CSS сохранился в длительном кеше под прежним URL, посетитель может увидеть новую разметку со старыми стилями.
Обновление без промежуточных состояний
При замене набора файлов можно сначала загрузить их во временный каталог, а после завершения переключить символическую ссылку или указатель на новую версию. Тогда посетитель не получит HTML, который ссылается на ещё не загруженные ресурсы.
Модуль file_server Caddy читает статические файлы непосредственно с диска: после изменения HTML перезапуск Caddy не требуется. Но фактическое появление новой версии у посетителя по-прежнему зависит от кеширования.