SquareCows/pages-server
1
0
Fork 0
Code Issues 6 Pull requests Projects 1 Releases 12 Packages Wiki Activity
12 releases 12 tags
  • v0.1.4 c38204b3c6

    v0.1.4 - Plugin Icon for Traefik Catalog Stable

    ric released this 2025-12-15 17:50:46 +00:00 | 2 commits to main since this release

    Added

    • Plugin Icon for Traefik Plugin Catalog: Added visual branding to improve plugin identification
      • Added .assets/icon.png with SquareCows logo for plugin catalog display
      • Added iconPath configuration to .traefik.yml pointing to plugin icon
      • Enhances plugin visibility and recognition in Traefik Plugin Catalog
      • Uses official SquareCows branding (black text cutout logo)

    Installation

    Add the plugin to your Traefik static configuration:

    experimental:
  plugins:
    pages-server:
      moduleName: github.com/sqcows/pages-server
      version: v0.1.4

    For complete installation and configuration instructions, see the README.

    Downloads
  • v0.1.3 67533c62df

    v0.1.3 - Remove External Dependencies Stable

    ric released this 2025-12-15 17:43:27 +00:00 | 3 commits to main since this release

    Changes

    This release removes the unused external dependency (github.com/go-acme/lego/v4) from go.mod, ensuring full compliance with Traefik plugin requirements.

    Changed

    • Removed External Dependencies: Removed unused external dependency from go.mod
      • Ensures full compliance with Traefik plugin requirements (standard library only)
      • Plugin now exclusively uses Go standard library packages
      • No functional changes to plugin behavior
      • Reduces potential security surface and dependency management overhead
      • Improves plugin compatibility with Traefik's Yaegi interpreter

    Installation

    Update your Traefik static configuration:

    experimental:
  plugins:
    pages-server:
      moduleName: github.com/sqcows/pages-server
      version: v0.1.3

    Upgrade Notes

    This is a maintenance release with no breaking changes. Simply update the version number in your Traefik configuration to upgrade.

    Full Changelog

    https://github.com/sqcows/pages-server/compare/v0.1.2...v0.1.3

    Downloads
  • v0.1.2 50ecf3b0ba

    v0.1.2 - Repository Migration to GitHub Stable

    ric released this 2025-12-15 17:29:52 +00:00 | 5 commits to main since this release

    Repository Migration to GitHub

    This release migrates the repository from code.squarecows.com/SquareCows/pages-server to github.com/sqcows/pages-server to comply with Traefik Plugin Catalog requirements.

    Changed

    • Repository Migration to GitHub: Migrated repository from code.squarecows.com/SquareCows/pages-server to github.com/sqcows/pages-server
      • Updated module path in go.mod to reflect new GitHub location
      • Updated all repository references in documentation to point to GitHub
      • Migration required for Traefik Plugin Catalog compatibility
      • Traefik requires plugins to be hosted on GitHub for proper plugin discovery and installation
      • No functional changes to the plugin code
      • All existing features and functionality remain unchanged

    Installation

    Update your Traefik configuration to use the new GitHub module path:

    experimental:
  plugins:
    pages-server:
      moduleName: github.com/sqcows/pages-server
      version: v0.1.2

    Full Changelog: https://github.com/sqcows/pages-server/compare/v0.1.1...v0.1.2

    Downloads
  • v0.1.1 05d7060670

    v0.1.1 - DNS Verification and Custom Domain Redirects Stable

    ric released this 2025-12-04 19:37:37 +00:00 | 7 commits to main since this release

    What's New in v0.1.1

    This release adds two major security and functionality features to Bovine Pages Server.

    DNS TXT Record Verification for Custom Domains

    A new optional security feature to prevent domain hijacking:

    • Ownership Verification: Requires DNS TXT record to prove domain ownership before registering custom domains
    • Security: SHA256 hash with constant-time comparison prevents timing attacks
    • Format: bovine-pages-verification=<SHA256_HASH> where hash = SHA256(owner/repository)
    • Configuration: Enable with enableCustomDomainDNSVerification: true (disabled by default)
    • Backward Compatible: Existing domains continue working when disabled
    • Helper Script: examples/generate-dns-verification-hash.sh for generating hashes
    • Comprehensive Tests: Full test coverage for hash generation and DNS verification

    Custom Domain Redirects

    A powerful URL redirect system for custom domains:

    • Simple Configuration: .redirects file in repository root with FROM:TO format
    • Easy Activation: Visit /LOAD_REDIRECTS endpoint to activate redirects
    • Traefik Integration: Automatically creates Traefik redirectregex middleware
    • Persistent Storage: Stores middleware configuration in Redis
    • Security: Configurable maxRedirects parameter (default: 25) prevents resource exhaustion
    • Flexible Format: Supports comments (#) and empty lines
    • Safe Regex: Automatic escaping of special characters
    • Permanent Redirects: 301 status for all redirects
    • Custom Domains Only: Works only on custom domains, not pages domain URLs
    • Redis Required: Requires Redis cache for middleware storage
    • User-Friendly: Beautiful HTML success/error pages with detailed instructions
    • Well Tested: >90% test coverage for redirects module

    Example: DNS Verification Setup

    # 1. Generate verification hash
./examples/generate-dns-verification-hash.sh squarecows bovine-website
# Output: 73bb8214899661e7f7900c77714586cc51702e6cf26a58c62e17fa9d88f3d3d3

# 2. Add DNS TXT record
TXT bovine.squarecows.com bovine-pages-verification=73bb8214899661e7f7900c77714586cc51702e6cf26a58c62e17fa9d88f3d3d3

# 3. Add to .pages file
enabled: true
custom_domain: bovine.squarecows.com

# 4. Visit pages URL to register
https://squarecows.pages.example.com/bovine-website

    Example: Custom Domain Redirects Setup

    # .redirects file in repository root
# Redirect old blog to new location
/old-blog:/blog
/about-us:/about

# Visit to activate
https://yourdomain.com/LOAD_REDIRECTS

    Breaking Changes

    None - both features are opt-in and backward compatible.

    Configuration

    DNS Verification (optional):

    enableCustomDomainDNSVerification: true  # default: false

    Redirects (optional):

    maxRedirects: 25  # default: 25, max redirects per domain

    Full Changelog

    See CHANGELOG.md for complete details.

    🤖 Generated with Claude Code

    Downloads
  • v0.0.9 4fcbebc218

    v0.0.9 - Documentation Improvements Stable

    ric released this 2025-12-04 13:42:30 +00:00 | 14 commits to main since this release

    Documentation Improvements

    This release focuses on enhancing project documentation through comprehensive wiki updates.

    Wiki Updates

    • Cache Management Page: Created comprehensive guide for managing Redis/Valkey cache including key structures, manual cache management commands, and troubleshooting tips
    • Quick Start Guide Enhancements: Improved getting started experience with clearer installation steps and configuration examples
    • Custom Domains Documentation Updates: Enhanced custom domain setup documentation with detailed DNS verification flow for the upcoming 0.1.0 release
    • Home Page Improvements: Restructured wiki home page for better navigation and accessibility

    Notes

    This is a documentation-only release with no code changes to the plugin itself. The wiki improvements provide better guidance for administrators and users deploying and managing the pages-server plugin.

    Installation

    No changes to installation process. Continue using v0.0.3 for production deployments.

    📚 Generated with Claude Code

    Downloads
  • v0.0.8 e8cdc8f173

    v0.0.8 - Directory Listings and Custom Domain Improvements Stable

    ric released this 2025-12-03 20:24:24 +00:00 | 16 commits to main since this release

    Highlights

    This release adds directory listings functionality and improves custom domain management with several bug fixes.

    New Features

    Directory Index (Apache-style directory listings)

    • Enable Apache-style directory listings for directories without index.html
    • Configure per-repository with directory_index: true in .pages file
    • Beautiful responsive HTML listing with file names, types, and sizes
    • Color-coded icons for files and folders
    • Parent directory navigation
    • Mobile-responsive design
    • Cached for 60 seconds for optimal performance

    Cache Reaper Script

    • Python script for automated cleanup of stale domain mappings
    • Connects to Redis and validates domain mappings against Forgejo API
    • Dry-run mode for safe testing
    • Designed for cron scheduling (hourly, daily, etc.)
    • Exit codes for monitoring and alerting
    • Full documentation in reaper/ directory

    Custom Domain Conflict Prevention

    • Validates custom domain ownership during registration
    • Prevents domain hijacking by checking existing mappings
    • Allows re-registration for the same repository (updates mappings)

    Bug Fixes

    Reaper Script: Added missing priority key to Traefik router cleanup

    • Now properly deletes all 6 Traefik router configuration keys
    • Prevents orphaned keys from remaining in Redis

    Custom Domain Reverse Mapping: Added persistent reverse mapping cache

    • Caches both forward (custom_domain:domain -> username:repository) and reverse (username:repository -> domain) mappings
    • Prevents custom domain resolution failures when forward mapping expires
    • Both mappings use TTL=0 (persistent storage) for reliability

    Documentation

    • Comprehensive wiki documentation for directory listings feature
    • Enhanced Quick Start guide with Traefik and Docker setup
    • Added Redis/Valkey requirement documentation
    • Architecture diagrams using Mermaid.js
    • Rebranded to "Bovine Pages Server"

    Installation

    Add to your Traefik configuration:

    experimental:
  plugins:
    pages-server:
      moduleName: code.squarecows.com/SquareCows/pages-server
      version: v0.0.8

    See the Quick Start Guide for complete setup instructions.

    Full Changelog

    See CHANGELOG.md for complete details.

    Downloads
  • v0.0.7 be39b4bccb

    v0.0.7 - Password Protection & Critical Bug Fixes Stable

    ric released this 2025-12-01 21:15:59 +00:00 | 24 commits to main since this release

    Release v0.0.7

    🎉 What's New

    🔒 Password Protection

    Protect your websites with secure password authentication:

    • Add password: field in .pages file with SHA256 hash
    • Automatic login page with beautiful gradient UI
    • Secure HMAC-signed cookies (HttpOnly, Secure, SameSite=Strict)
    • Configurable auth cookie duration (default: 1 hour)
    • Password hash caching with 60-second TTL
    • Per-repository authentication

    🐛 Critical Bug Fixes

    • CRITICAL: Traefik Router Expiration: Fixed bug where router configurations were expiring after 10 minutes
      • Changed default traefikRedisRouterTTL from 600 seconds to 0 (persistent)
      • Router configurations now persist until explicitly deleted
      • Prevents custom domain sites from disappearing from Traefik
      • External reaper process should clean up stale routers

    📚 Documentation

    • Moved CUSTOM_DOMAINS.md to wiki for better organization
    • Added comprehensive password protection documentation to README and wiki
    • Updated configuration examples with new auth parameters

    📦 Installation

    Update your Traefik configuration to use v0.0.7:

    experimental:
  plugins:
    pages-server:
      moduleName: code.squarecows.com/SquareCows/pages-server
      version: v0.0.7

    🔗 Links

    Downloads
  • v0.0.6 eab9278acc

    v0.0.6 - Critical Bug Fixes and New Features Stable

    ric released this 2025-12-01 20:26:04 +00:00 | 31 commits to main since this release

    Critical Fixes

    Redis Binary Data Corruption (CRITICAL)

    Fixed a critical bug causing data corruption when reading large files from Redis cache:

    • Changed reader.Read() to io.ReadFull() in Redis RESP protocol bulk string reader
    • reader.Read() doesn't guarantee reading all bytes at once, causing partial reads for large files
    • This caused CSS/JS files to be corrupted when served from Redis cache
    • Resulted in Subresource Integrity (SRI) hash mismatches and broken styling
    • Files are now read completely and correctly from Redis cache
    • Action Required: Clear your Redis cache after updating to remove corrupted data

    SVG File Corruption

    Fixed "Char 0x0 out of allowed range" errors when serving SVG files:

    • Replaced custom base64 decoder with Go's standard library encoding/base64
    • Removed buggy custom base64Decode and base64DecodedLen functions
    • Fixes corruption issues with binary files (SVGs, images, fonts)
    • Standard library decoder is more robust and well-tested

    New Features

    Directory Index Support

    Automatic index.html detection for directory URLs:

    • Accessing /pricing/ now automatically tries /pricing/index.html
    • Enables clean URLs without file extensions
    • Only applies to paths without file extensions (directories)
    • Falls back to 404 if neither the directory nor index.html exists
    • Standard web server behavior for improved user experience

    Persistent Custom Domain Storage

    Custom domain mappings now stored without TTL:

    • Changed customDomainCache initialization to use TTL=0 (persistent storage)
    • Modified SetWithTTL() to use SET command instead of SETEX when TTL=0
    • Modified MemoryCache to use expiration=-1 for never-expiring items
    • Enables external reaper scripts to validate and clean up domains via cron
    • Domain mappings persist until explicitly deleted
    • No impact on file content cache (still uses configured TTL)

    HTTP Response Headers

    Added server identification and cache status headers:

    • Added Server: bovine header to all responses (content and error pages)
    • Added X-Cache-Status: HIT header when serving content from cache
    • Added X-Cache-Status: MISS header when fetching content from Forgejo API
    • Enables monitoring and debugging of cache behavior

    Upgrade Instructions

    1. Update the plugin version in your Traefik configuration to v0.0.6
    2. IMPORTANT: Clear your Redis cache to remove corrupted data: 
      redis-cli FLUSHDB
    3. Restart Traefik to load the updated plugin
    4. Verify the site loads correctly with proper CSS/JS

    Full Changelog

    See CHANGELOG.md for complete details.

    Downloads
  • v0.0.5 593e740ae9

    v0.0.5 - Router Configuration Documentation Fixes Stable

    ric released this 2025-11-29 13:09:50 +00:00 | 39 commits to main since this release

    Release v0.0.5

    Documentation-only release that corrects router configuration examples in README.md to match the actual implementation.

    🔧 Fixed

    Router Configuration Documentation

    • Removed incorrect tls.certResolver from pages-custom-domains-https router example
      • The catch-all router should NOT have a certResolver
      • Individual domains get their own routers dynamically created in Redis with proper SSL configuration
    • Updated custom domain setup instructions:
      • Added step 3: Configure Traefik static config with Redis provider
      • Clarified that plugin writes router configurations to Redis
      • Explained that Traefik Redis provider loads routers and requests SSL certificates automatically
    • Fixed configuration examples to match actual implementation behavior

    📚 Documentation

    • Updated custom domain setup with Redis provider configuration requirement
    • Clarified catch-all router behavior vs. individual Redis routers
    • Added explanatory comments to router configuration examples

    📝 Note

    This is a documentation-only release. No code changes from v0.0.4. The configuration examples in the README were incorrect and could cause confusion. This release corrects those examples to match how the Redis router integration actually works.

    See CHANGELOG.md for full details.

    Downloads
  • v0.0.4 645af5fe57

    v0.0.4 - Redis Router Integration & SSL Certificate Fixes Stable

    ric released this 2025-11-29 13:04:36 +00:00 | 41 commits to main since this release

    Release v0.0.4

    Major improvements for automatic SSL certificate generation and custom domain support.

    🔧 Fixed

    ACME Challenge Passthrough

    • Critical fix: Middleware was redirecting ACME HTTP challenges to HTTPS, preventing SSL certificate generation
    • Added automatic detection of /.well-known/acme-challenge/* paths
    • ACME challenges now pass through to Traefik's handler before HTTPS redirect
    • Enables Let's Encrypt to validate custom domains and generate SSL certificates
    • No configuration changes required - works automatically

    Redis Router Registration

    • Fixed service reference: Changed from pages-noop to noop@internal (Traefik's built-in service)
    • Fixed middleware reference: Changed from pages-server to pages-server@file (fully qualified name)
    • Eliminates "service does not exist" and "middleware does not exist" errors in Traefik dashboard
    • No external service configuration required

    Router Configuration

    • Split HTTP (web) and HTTPS (websecure) routers properly
    • Removed incorrect pattern where both entrypoints were on same router with TLS
    • Updated examples/traefik-config.yml with correct 3-router pattern

    📚 Documentation

    • Added comprehensive "Traefik Redis Provider Integration" section to README.md
    • Added ACME Challenge Handling section explaining automatic passthrough
    • Added troubleshooting section for SSL certificate generation issues
    • Created IMPLEMENTATION_SUMMARY.md documenting the Traefik Redis provider implementation
    • Updated all configuration examples with proper router structure

    🚀 Impact

    • Custom Domains: SSL certificates now generate correctly for custom domains
    • Deployment: Existing deployments must update router configuration to split HTTP/HTTPS
    • Security: HTTPS redirect still works for all non-ACME requests

    See CHANGELOG.md for full details.

    Downloads