dnsmgr (彩虹聚合DNS管理系统)

You can deploy dnsmgr on any environment supporting PHP and MySQL (e.g., BT Panel, Kangle).

Requirements:

• PHP 8.0+
• MySQL 5.6+

Steps:

1. Download the installation package from the Releases page.
2. Set the website running directory to public.
3. Configure pseudo-static (rewrite) rules based on your web server (see Nginx/Apache sections).
4. If using the Source code package, install dependencies via Composer:

   composer install --no-dev

5. Access the website URL; it will automatically redirect to the installation page. Follow the prompts to complete setup.
6. Log in to the control panel via the homepage.

Updating: To update, simply upload and overwrite the existing files with a new installation package.

Run dnsmgr as a single container. The application will listen on port 8081 by default.

Run Command:

docker run --name dnsmgr -dit -p 8081:80 -v /var/dnsmgr:/app/www netcccyun/dnsmgr

Notes:

• If the disaster recovery switching (容灾切换) does not start automatically after installation, restart the container:

  docker restart dnsmgr

- To pull from a domestic (China) mirror:
  ```bash
docker pull swr.cn-east-3.myhuaweicloud.com/netcccyun/dnsmgr:latest

The connection pool behavior is governed by configuration keys. When defining your database connection configuration, you can specify:

• pool_size: The maximum number of connections to maintain in the pool. Defaults to 32 if not specified.
• pool_timeout: The maximum time (in seconds) to wait for a connection to become available from the pool. Defaults to 3 if not specified.

The setpwd method allows users to update their password. This requires administrative permission.

Request Requirements:

• Method: POST
• Parameters:
  • oldpwd: The current password.
  • newpwd: The new password.
  • newpwd2: The new password repeated for verification.

Responses:

• `{

To ensure dnsmgr (built on ThinkPHP) functions correctly, you must configure the appropriate rewrite rules for your web server.

Nginx Configuration:

location ~* (runtime|application)/ {
    return 403;
}
location / {
    if (!-e $request_filename) {
        rewrite ^(.*)$ /index.php?s=$1 last; break;
    }
}

Apache Configuration:

<IfModule mod_rewrite.c>
  Options +FollowSymlinks -Multiviews
  RewriteEngine On

  RewriteCond %{REQUEST_FILENAME} !-d
  RewriteCond %{REQUEST_FILENAME} !-f
  RewriteRule ^(.*)$ index.php/$1 [QSA,PT,L]
</IfModule>

The tos_request() method is a specialized request handler designed for TOS (TOS4) services. It uses different header requirements, specifically X-Tos-Date and X-Tos-Content-Sha256 for signature verification.

Parameters:

• $method (string): The HTTP method (e.g., 'GET', 'POST').
• $params (array, optional): The request parameters. If the method is not 'GET', these are JSON-encoded into the request body.
• $query (array, optional): Query parameters to be appended to the URL.

Returns:

• Returns the contents of the Result key from the JSON response on success.
• Returns true if the response is successful but contains no Result key.

Throws:

• Exception: Thrown on cURL errors or API error responses.

The system provides a dedicated API group under the /api prefix. All routes in this group are protected by the AuthApi middleware. These endpoints are intended for programmatic access to domain and record data.

API Routes:

• POST /api/domain/:id -> domain/domain_info (Get domain info)
• POST /api/domain -> domain/domain_data (Submit domain data)
• POST /api/record/data/:id -> domain/record_data (Get record data)
• POST /api/record/add/:id -> domain/record_add (Add a record)
• POST /api/record/update/:id -> domain/record_update (Update a record)
• POST /api/record/delete/:id -> domain/record_delete (Delete a record)
• POST /api/record/status/:id -> domain/record_status (Check record status)
• POST /api/record/batch/:id -> domain/record_batch (Batch record operations)
• POST /api/cert/order -> cert/order_info (Get certificate order info)

Use the request() method to perform HTTP operations against the China Telecom Cloud API. The method handles canonicalization, signature generation (Eop-Authorization), and JSON encoding for request bodies.

Parameters:

• $method (string): The HTTP method (e.g., 'GET', 'POST').
• $path (string): The API resource path.
• $query (array|null): Key-value pairs for URL query parameters.
• $params (array|null): Key-value pairs for the JSON request body.
• $header (array|null): Additional custom HTTP headers.

Returns:

• Returns the contents of returnObj from the API response on success.
• Throws an Exception if the API returns an error message or if a cURL error occurs.