Releases: Thoseyearsbrian/GeoIP2-CN
GeoIP2-CN v1.0.10
GeoIP2-CN v1.0.10 — Clarifies Legal Use Based on User’s Own MaxMind License Key
This version updates the project description to clarify:
This project only provides automation scripts. Users must use their own valid MaxMind License Key to generate the database files. All IP geolocation data is constructed by users independently and legally, in full compliance with MaxMind’s license agreement and usage terms.
Updates:
• Revised README to emphasize the legal basis of database generation
• Clearly stated that the project does not distribute or provide IP data files
• Improved structure and language for better compliance and clarity
release: GeoIP2-CN v1.0.10 — Clarifies Legal Use Based on User’s Own MaxMind License Key
GeoIP2-CN v1.0.9
GeoIP2-CN v1.0.9 — Establishing Governance Framework and Issuing Mirror-Prohibited Statement
This update introduces the new “Mirror-Prohibited” badge along with an official statement clarifying that the project is hosted exclusively on GitHub and does not authorize any third-party platforms (such as GitCode or Gitee) to perform mirroring or replication.
Changes:
• Added the Mirror-Prohibited badge to explicitly indicate that mirroring is not permitted
• Synchronized updates across both Chinese and English documentation to maintain consistency
release: GeoIP2-CN v1.0.9 — Establishing Governance Framework and Issuing Mirror-Prohibited Statement
GeoIP2-CN v1.0.8
GeoIP2-CN v1.0.8 — Terminology Refinement in Project Overview
This version updates the wording in the “Project Overview” section of the README to improve accuracy and alignment with the project’s actual behavior, replacing the previous term “independent updates” with the more appropriate “automated updates.”
Changes:
• Replaced “independent updates” with “automated updates” to reflect the actual GitHub Actions–based update mechanism
• Synchronized updates across both Chinese and English documentation
–––
release: GeoIP2-CN v1.0.8 — Terminology Refinement in Project Overview
GeoIP2-CN v1.0.7
GeoIP2-CN v1.0.7 — Refined Overview Description
This release focuses on improving the “Project Overview” section of the README, ensuring that the description more accurately reflects the core operating model of GeoIP2-CN:
The project relies on the user’s own MaxMind License Key to automatically build the China-mainland IP range database, ensuring that all data retrieval fully complies with the MaxMind license agreement.
Changes:
• Refined the “Project Overview” text to clearly state that database construction is based on the user-provided License Key
• Strengthened compliance-related explanations to clarify the project’s intended scope and usage boundaries
• Updated both Chinese and English documentation to maintain consistency and unified terminology
• No changes were made to scripts or file paths — this update is documentation-only for greater accuracy
–––
release: GeoIP2-CN v1.0.7 — Refined Overview Description
GeoIP2-CN v1.0.6
GeoIP2-CN v1.0.6 — Documentation Structure Refinement and Branding Consistency Update
This version focuses on improving the documentation structure, enhancing brand visual consistency, and providing a clearer user experience during configuration and onboarding. No changes were made to core scripts or the data build pipeline; all updates are documentation-oriented refinements.
Changes:
• Added the Aegis branding logo to the GeoIP2-CN documentation to maintain visual consistency across the project series
• Introduced the “Configuration Guide” and “Usage Guide” sections to clarify essential steps for first-time users
• Rewrote several explanatory sections to improve readability, precision, and structural clarity of the README
• Enhanced both Chinese and English documentation to ensure consistent formatting and terminology alignment
• No changes to paths, scripts, or the build workflow — this release focuses solely on documentation quality improvements
release: GeoIP2-CN v1.0.6 — Documentation Structure Refinement and Branding Consistency Update
GeoIP2-CN v1.0.5
GeoIP2-CN v1.0.5 — Optimization of Project Description and Platform Support
This update focuses on refining the project’s main documentation (README) to better articulate GeoIP2-CN’s positioning as a solution, and to officially include support for Shadowrocket as a compatible platform. The changes aim to improve clarity, precision, and platform coverage, ensuring that domestic users have a more complete and trustworthy solution for automatically building geolocation databases.
This version is dedicated to documentation structure refinement, enhanced tool compatibility, and clearer language to better convey the project’s scope and usage context.
Changes:
• Improved terminology and sentence structure in the English README for consistency and professionalism
• Updated the main README to emphasize its nature as a “solution”
• Added official Shadowrocket (iOS) support statement
• Refined the tool support descriptions across both Chinese and English versions
• No changes to project paths or scripts — all updates are documentation enhancements only
release: GeoIP2-CN v1.0.5 — Optimization of Project Description and Platform Support
GeoIP2-CN v1.0.4
GeoIP2-CN v1.0.4 — Update of Notices and Legal Usage Declaration
This release focuses on a comprehensive revision of the “Notices” and “Usage Restrictions” sections in the project documentation. It officially replaces the previous MIT license with Apache License 2.0, and provides clearer guidance for the compliant use of GeoLite2 data. Key updates include:
• All data usage must comply with the MaxMind GeoLite2 EULA
• Project scripts and configuration files are now governed by Apache License 2.0 with proper copyright attribution
• GitHub Actions commits are not GPG-signed; only manual commits from the developer are signed for authenticity
• GEOIP matching is recommended only for China (CN); other country codes are not supported in this build
• Commercial usage is strictly prohibited; users are advised to apply for a MaxMind License Key for lawful access
This version aims to enhance the project’s legal clarity, transparency, and user guidance for safe, lawful, and controllable data usage.
Changes:
• Explicitly prohibit commercial use and enhance the disclaimer to improve legal compliance and user awareness
• Officially update the project license from MIT to Apache License 2.0
• Emphasize the importance of obtaining and using a personal License Key from MaxMind
• Clarify the difference between GitHub Actions automation and manually signed developer commits
• Add warnings about GEOIP usage limitations — only CN (China) is valid in this release
• Improve terminology and structure in both Chinese and English docs for legal clarity and technical precision
release: GeoIP2-CN v1.0.4 — Update of Notices and Legal Usage Declaration
GeoIP2-CN v1.0.3
GeoIP2-CN v1.0.3 — Add Standard Apache License File for SPDX Recognition
This release introduces a fully standardized LICENSE file using the Apache License 2.0 template. It ensures SPDX-compatible tools and GitHub can properly detect and display the license type. This update improves the legal compliance and professionalism of the project, aligning with community standards.
Changes:
• Add official Apache 2.0 LICENSE file (fully SPDX-compliant)
• Append copyright line: Copyright 2025 ThoseYearsBrian
• Adjust LICENSE appendix to replace placeholder values with author info
• Confirm GitHub now recognizes the license type as Apache-2.0
–––
release: GeoIP2-CN v1.0.3 — Add Standard Apache License File for SPDX Recognition
GeoIP2-CN v1.0.2
GeoIP2-CN v1.0.2 — Add English Setup Guide and Bidirectional Doc Navigation
This update focuses on documentation improvements. It adds an English version of the Surge configuration guide and introduces bidirectional navigation links between English and Chinese docs to enhance accessibility for global users.
Changes:
• Add step-by-step Surge config guide in English
• Add “Chinese Documentation” link at the top of the English README
• Add “English Documentation” link at the top of the Chinese README
• Fix incorrect GeoLite2 database link in English README (reference path adjusted)
–––
release: GeoIP2-CN v1.0.2 — Add English Setup Guide and Bidirectional Doc Navigation
GeoIP2-CN v1.0.1
GeoIP2-CN v1.0.1 — documentation structure updated
This is a minor update focused on improving the documentation and tutorial structure. No changes were made to the core database or update mechanisms.
Changes:
• Corrected the Surge GeoIP configuration tutorial image URL
• Added a step-by-step visual tutorial for importing GeoIP in Surge
• Improved image organization under Icons/Groups
This update improves the user onboarding experience and ensures consistency between documentation and hosted assets, laying the foundation for future instructional improvements.
release: GeoIP2-CN v1.0.1 — documentation structure updated