IP Region
Artalk has a built-in feature to display the geolocation of user IPs, with adjustable precision levels: city or province.
This feature is disabled by default. You can enable the IP region display feature in the Artalk Dashboard settings.
IP Region Database
Before enabling the IP region display feature, you need to download a database file:
- GitHub Download / Mirror Download (recommended within China)
After downloading, manually place it in the ./data/ directory, and name the file: ip2region.xdb.
Precision Settings
You can find this configuration item in the settings.
| Precision Level | Description | Example |
|---|---|---|
province | Province (default) | Sichuan |
city | City | Sichuan Chengdu |
country | Country/Region | China |
Configuration file:
# IP Region
ip_region:
# Enable IP region display
enabled: false
# Data file path (.xdb format)
db_path: ./data/ip2region.xdb
# Display precision ["province", "city", "country"]
precision: provinceObtaining the Correct IP Address
If you are using a CDN or a trusted reverse proxy server like Nginx, you need to specify the request header field containing the user's real IP in the "Settings" - "Server" option - "Proxy Header Name (http.proxy_header)", such as X-Real-IP (for security, this field is empty by default). After modification, please manually restart the Artalk service to take effect.
Otherwise, Artalk will not be able to obtain the user's real IP address (if using Docker, the IP obtained may always be 172.17.0.X, which is the IP of the Docker virtual network card).
Privacy Policy
Artalk comments will record users' IP and User-Agent data. Since such data pertains to user privacy, please declare this in your website's privacy policy and inform users that privacy data will be collected when they comment.
qwqcode