青龙面板[Qinglong] icon

青龙面板[Qinglong]

青龙面板计划任务节点.详细API请参考：https://qinglong.online/api/

Actions64

Overview

This node integrates with the Qinglong Panel API, a task scheduling and environment management platform. It allows users to manage various resources such as cron jobs, subscriptions, environment variables, configurations, scripts, dependencies, logs, and system settings through n8n workflows.

Specifically, for the "环境变量" (Environment Variable) resource and the "更新环境变量" (Update Environment Variable) operation, the node updates an existing environment variable by sending a PUT request with the updated data. This is useful in scenarios where you need to programmatically modify environment variables used by scheduled tasks or scripts managed in Qinglong, enabling dynamic configuration changes without manual intervention.

Practical examples:

  • Automatically update API keys or tokens stored as environment variables when they are rotated.
  • Modify script parameters or flags stored as environment variables based on external triggers.
  • Manage environment variables across multiple Qinglong instances via automated workflows.

Properties

Name Meaning
请求Body JSON object representing the environment variable to update. It includes:
- id: The ID of the environment variable (number).
- name: The name/key of the variable (string).
- value: The value of the variable (string).
- remarks: Optional remarks or comments about the variable (string).

The property expects a JSON input structured like this example:

{
  "id": "环境变量ID:number",
  "name": "变量名:string",
  "value": "变量值:string",
  "remarks": "备注（可选）:string"
}

Output

The node outputs the result of the Qinglong API call in the json field of the first item of the output array under the key result. This typically contains the response from the Qinglong server confirming the update status or details of the updated environment variable.

Example output structure:

{
  "result": {
    // API response data confirming update success or error details
  }
}

No binary data output is produced by this operation.

Dependencies

  • Requires an API authentication token credential configured in n8n to access the Qinglong API.
  • The node depends on the Qinglong Panel API being accessible and properly configured.
  • No additional external services are required beyond the Qinglong API.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication failures.
    • Incorrect or incomplete JSON in the "请求Body" property may lead to API errors.
    • Specifying an invalid environment variable ID or non-existent variable will result in update failure.
    • Network connectivity issues to the Qinglong API endpoint can cause request timeouts or errors.

  • Error messages:

    • Errors thrown by the node include messages indicating unimplemented operations if the selected operation is not supported.
    • API errors returned from Qinglong will be included in the node's error output; check the message for details such as invalid parameters or permission issues.

  • Resolution tips:

    • Verify that the API token credential is valid and has sufficient permissions.
    • Ensure the JSON body is correctly formatted and includes all required fields.
    • Confirm the environment variable ID exists in Qinglong before attempting an update.
    • Check network connectivity and Qinglong server status.

Links and References

Discussion