青龙面板[Qinglong] icon

青龙面板[Qinglong]

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

Actions64

Overview

This node integrates with the Qinglong Panel API to manage environment variables and other related resources such as crontabs, subscriptions, configs, scripts, dependencies, logs, and system settings. Specifically, for the "环境变量" (Environment Variable) resource with the "创建环境变量" (Create Environment Variable) operation, it allows users to create new environment variables by sending a JSON array of variable definitions to the Qinglong API.

Common scenarios where this node is beneficial include automating the management of environment variables in Qinglong, such as adding new variables programmatically during CI/CD workflows or dynamically updating configuration values without manual intervention.

Practical example: You want to add multiple environment variables to your Qinglong instance to configure scripts or tasks. Using this node, you can define these variables in JSON format and create them in bulk via the API.

Properties

Name Meaning
请求Body JSON array defining environment variables to create. Each item should include:
- 变量名 (variable name): Must start with a letter or underscore, only letters, numbers, and underscores allowed.
- value: The value of the variable.
- remarks: Optional notes about the variable.

Example of the JSON structure expected in 请求Body:

[
  {
    "name": "MY_VAR",
    "value": "some_value",
    "remarks": "Optional note"
  }
]

Output

The node outputs the result of the API call in the json field under the property result. This typically contains the response from the Qinglong API after creating the environment variables, which may include success confirmation, IDs of created variables, or error messages if any.

No binary data output is involved.

Dependencies

  • Requires an API key credential for authenticating with the Qinglong Panel API.
  • The node uses internal helper functions to obtain tokens and make authenticated HTTP requests to Qinglong's REST API endpoints.
  • Proper configuration of the Qinglong API credentials within n8n is necessary.

Troubleshooting

  • Invalid JSON in 请求Body: If the JSON input is malformed or does not conform to the expected structure (e.g., missing required fields like name or invalid characters in variable names), the API will likely reject the request. Ensure the JSON is valid and follows naming rules.
  • Authentication errors: If the API key or token is incorrect or expired, the node will fail to authenticate. Verify that the API credentials are correctly set up in n8n.
  • Unsupported operations: If an unsupported operation is selected, the node throws an error indicating the operation is not implemented.
  • API endpoint errors: Network issues or Qinglong API downtime can cause failures. Check connectivity and API status.
  • Error messages: The node throws detailed errors with messages and descriptions from the API, which help identify the problem.

Links and References

Discussion