青龙面板[Qinglong]

Overview

This node integrates with the Qinglong Panel API to manage scheduled tasks (crontabs) and other related resources such as subscriptions, environment variables, configurations, scripts, dependencies, logs, and system settings. Specifically, for the "定时任务" (Scheduled Task) resource and the "置顶任务" (Pin Task) operation, it allows users to pin selected scheduled tasks to the top of the task list in Qinglong.

Common scenarios where this node is beneficial include:

• Automating the management of scheduled tasks on Qinglong, such as running, stopping, enabling, disabling, deleting, or pinning tasks.
• Managing environment variables, scripts, and dependencies programmatically.
• Retrieving logs and system information from Qinglong.
• Integrating Qinglong task management into broader n8n workflows for automation.

Practical example:

• Pinning important scheduled tasks so they appear at the top of the Qinglong dashboard for quick access and monitoring.
• Running or stopping multiple scheduled tasks simultaneously by selecting them in the node.

Properties

The property "任务列表【可多选】" corresponds to crontabIds and allows selecting one or more scheduled tasks by their IDs. The options are dynamically loaded from the Qinglong API to present available crontab tasks.

Output

The node outputs a JSON object under the field result which contains the response from the Qinglong API corresponding to the requested operation. This typically includes success status, data about the affected tasks, or error messages if any.

No binary data output is produced by this node.

Example output structure:

{
  "result": {
    // API response data, e.g., confirmation of pinned tasks
  }
}

Dependencies

• Requires an API key credential for authenticating with the Qinglong Panel API.
• The node uses HTTP requests to Qinglong's REST API endpoints.
• The user must configure the Qinglong API credentials in n8n before using this node.

Troubleshooting

• Common issues:

  • Invalid or missing API credentials will cause authentication failures.
  • Selecting invalid or non-existent task IDs may result in errors from the Qinglong API.
  • Network connectivity issues can prevent successful API calls.

• Error messages:

  • "任务模块的<operation>操作暂未实现" ("The operation of the task module is not yet implemented"): Indicates that the selected operation is not supported by the node.
  • API errors returned from Qinglong will be passed through; check the API response for details.

• Resolutions:

  • Verify that the API key credential is correctly configured and has necessary permissions.
  • Ensure the selected task IDs exist and are valid.
  • Check network connectivity and Qinglong server availability.

Links and References

• Qinglong Panel API documentation: https://qinglong.online/api/