• English
  • Breaking Changes

    v1.7.0

    Storage System Redesign (⚠️ Configuration Update Required)

    Storage Connection String Changes

    TypeOld FormatNew FormatStatus
    Local Diskdisk://path=...disk://path=...✅ No change
    AWS S3keyId=...;key=...accessKey=...;secretKey=...❌ Parameters renamed
    MinIO S3keyId=...;key=...accessKey=...;secretKey=...❌ Parameters renamed
    Azure Blobazure.blobs://...❌ Not supported❌ Removed

    ⚠️ Required Updates

    AWS S3 / MinIO users:

    Update ConnectionStrings:Storage:

    OLD: aws.s3://keyId=AKIA...;key=secret...;bucket=my-bucket;region=us-east-1
    NEW: aws.s3://accessKey=AKIA...;secretKey=secret...;bucket=my-bucket;region=us-east-1
    
    OLD: minio.s3://keyId=admin;key=admin;bucket=gzctf;serviceUrl=http://minio:9000
    NEW: minio.s3://accessKey=admin;secretKey=admin;bucket=gzctf;endpoint=http://minio:9000;forcePathStyle=true

    Azure Blob users:

    Azure Blob Storage is no longer supported. Migrate to AWS S3 or MinIO:

    1. Choose alternative storage
    2. Migrate file data
    3. Update GZCTF configuration
    4. Restart GZCTF

    S3 Parameters

    • accessKey (required*): AWS Access Key ID
    • secretKey (required*): AWS Secret Access Key
    • bucket (required): Bucket name
    • region (required**): AWS region
    • endpoint (optional): Custom URL for MinIO
    • useHttp (optional): Use HTTP (default: false)
    • forcePathStyle (optional): Path-style URLs (default: false)
    • sessionToken (optional): Temporary credentials

    * If omitted, AWS default credential chain is used ** Either region or endpoint must be specified

    ⚠️ Database upgraded automatically. Downgrade not supported.

    v1.2.2

    Breaking Changes

    • Removed the Google ReCaptcha verification code configuration item

      Update steps: Delete the Google ReCaptcha verification code configuration item and choose other verification methods, such as Cloudflare Turnstile verification code.

    v0.24

    Breaking Changes

    • The SendMailAddress has been renamed to SenderAddress

      Update steps: Modify the SendMailAddress configuration key to SenderAddress

    v0.18

    • New: Preliminary support for i18n multi-language support, currently supporting Chinese, Japanese, and English

    Breaking Changes

    • The database structure is no longer compatible with the previous version, and the database needs to be reinitialized. If you need to keep the data, please use the v0.17 tag

      Update steps: Delete or backup the original database and reinitialize the database

    • The default exposed port of the container has been changed from 80 to 8080

      Update steps: Modify the exposed port of the container to 8080

      Reference: Default ASP.NET Core port changed from 80 to 8080

    v0.17

    Breaking Changes

    • Moved the original uploads directory to files/uploads, removed the configuration item for this directory, and changed the location of the log storage

      Update steps: Move the original uploads directory to files/uploads, remount the relevant directories, and delete the configuration item for the uploads directory and the original log directory.

    v0.16-v0.1

    Please check the release notes: https://github.com/GZTimeWalker/GZCTF/releases