GZ::CTF
Guide
Config
API Reference
Guide
Config
API Reference

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

Table of Contents