Files and scheduled tasks

This guide covers two tabs on the Dedicated Container page, 文件管理 (Files) and 计划任务 (Scheduled tasks). It explains how to upload, edit, compress and extract files, and how to run commands on a schedule inside the container.

#File manager

Open the container page and switch to the 文件管理 (Files) tab. The file manager's root / is the container's site and application directory, /var/www/html. You can browse and change only this directory and its subdirectories.

#Browsing and editing

• Click a directory name to open it. Use the breadcrumb path at the top to go back up.
• The list shows 名称 (Name), 大小 (Size), modification time and 权限 (Permissions).
• Click the More (⋯) button next to a file for these actions:

#Creating, uploading and remote download

The toolbar has these buttons:

• 上传 (Upload): upload a local file into the current directory.
• 远程下载 (Remote download): enter a 下载URL (Download URL), such as https://example.com/file.zip, and a 保存文件名 (Save as) name. The server downloads the file straight into the current directory. The download runs in the background with a progress indicator, and "远程下载完成" (Remote download complete) appears when it finishes.
• 新建 (New): choose a type (file or directory) and enter a name.
• 刷新 (Refresh): reload the current directory.

Compression and extraction also run in the background. You'll see "压缩完成" (Compression complete) or "解压完成" (Extraction complete) when they finish.

#File permissions

Apps and scheduled cron jobs run as the container's www user. If you run into permission problems, click 修复权限 (Fix permissions) under 快捷操作 (Quick actions) on the 概览 (Overview) tab. This resets the owner and permissions of /var/www/html.

#Scheduled tasks (cron)

The 计划任务 (Scheduled tasks) tab runs commands inside the container on a cron schedule. Typical uses are running the Laravel scheduler, clearing caches or taking periodic backups.

#Creating a scheduled task

1. Switch to the 计划任务 (Scheduled tasks) tab and click 新建任务 (New task).

2. Fill in the form:

   Field	Description
   任务名称 (Task name)	A name that helps you recognise the task, e.g. backup_database
   执行计划 (Cron表达式) (Schedule)	A standard 5-field cron expression: minute, hour, day of month, month, day of week, e.g. */5 * * * *. Use 快速选择 (Quick select) to pick a common preset
   执行命令 (Command)	The command to run. Use absolute paths, e.g. /usr/bin/php /var/www/html/artisan schedule:run
   执行用户 (Run as)	The user that runs the command
   描述 (Description)	Optional notes

3. Save. The task then appears in the list.

#Cron expressions

An expression has five fields with these ranges:

Common examples:

* * * * *      every minute
*/5 * * * *    every 5 minutes
0 * * * *      at the top of every hour
0 0 * * *      every day at 00:00
0 12 * * *     every day at 12:00
0 0 * * 1      every Monday at 00:00
0 0 1 * *      on the 1st of every month at 00:00

#Managing tasks

The list shows 执行计划 (Schedule), 命令 (Command), 执行用户 (Run as) and 状态 (Status). Each row has these controls:

• Status switch: enable or disable the task.
• 立即执行 (Run now) (the play icon): run the command once right away and show its output. This is useful for debugging.
• 编辑 (Edit): change the schedule, command and other fields.
• 删除 (Delete): delete the task after you confirm.

#Writing good commands

• Scheduled runs use the container's www user, so that user must be able to read and write the files your command uses.
• Don't put single quotes (') in the command. For complex logic, put the commands in a script such as /var/www/html/cron.sh and have the task run sh /var/www/html/cron.sh.
• To keep a record of each run, redirect the output yourself, e.g. ... >> /var/www/html/storage/cron.log 2>&1.

#About the web terminal

The container page also has a Web终端 (Web terminal) tab.