update

docs/_coverpage.md

@@ -15,6 +15,6 @@
 <a href="https://hellogithub.com/repository/c69089b776704985b989f98626de977a" target="_blank"><img src="https://abroad.hellogithub.com/v1/widgets/recommend.svg?rid=c69089b776704985b989f98626de977a&claim_uid=ekhLfDOxR5U0mVw&theme=small" alt="Featured｜HelloGitHub" /></a>
 
 [GitHub](https://github.com/donknap/dpanel)
-[Pro版](https://doc.dpanel.cc/#/zh-cn/manual/pro)
-[面板介绍](https://doc.dpanel.cc/#/README)
-[快速开始](https://doc.dpanel.cc/#/zh-cn/install/docker)
+[Pro版](/zh-cn/manual/pro)
+[面板介绍](/README)
+[快速开始](/zh-cn/install/docker)

docs/_sidebar.md

@@ -11,9 +11,10 @@
     * [关联容器](zh-cn/manual/container/create-link.md)
     * [基础镜像](zh-cn/manual/container/create-image.md)
     * [参数详解](zh-cn/manual/container/create-option.md)
-  * **容器设置**
+  * **容器管理**
     * [绑定宿主机网络](zh-cn/manual/container/bind-host-network.md)
     * [配置镜像仓库](zh-cn/manual/image/registry.md)
+    * [计划任务](zh-cn/manual/container/cron.md)
   * **Compose**
     * [创建任务](zh-cn/manual/compose/create.md)
     * [环境变量](zh-cn/manual/compose/env.md)
@@ -36,6 +37,7 @@
     * [服务器Ip](zh-cn/manual/setting/server.md)
     * [多环境管理](zh-cn/manual/setting/docker-env.md)
     * [应用商店](zh-cn/manual/setting/store.md)
+    * [脚本模板](zh-cn/manual/setting/cron-template.md)
     * [更新DPanel面板](zh-cn/manual/setting/upgrade.md)
   * **其它**
     * [远程管理](zh-cn/manual/system/remote.md)

docs/index.html

@@ -10,8 +10,6 @@
   <link rel="stylesheet" href="//cdn.jsdelivr.net/npm/docsify@4/lib/themes/buble.css">
   <link rel="stylesheet" href="https://unpkg.com/[email protected]/dist/light.css">
   <script src="//cdn.jsdelivr.net/npm/docsify-edit-on-github"></script>
-  <script async src="https://pagead2.googlesyndication.com/pagead/js/adsbygoogle.js?client=ca-pub-1086432794987062"
-    crossorigin="anonymous"></script>
   <style type="text/css">
     section.cover ul {
       line-height: 1.8;
@@ -32,7 +30,7 @@
     <a target="_blank" href="https://demo.dpanel.cc">演示</a>
     <a target="_blank" href="https://qm.qq.com/q/2v4x9x8q4k">Q群</a>
     <a target="_blank" href="https://afdian.com/a/dpanel">赞助</a>
-    <a href="https://doc.dpanel.cc/#/zh-cn/manual/license">许可</a>
+    <a href="https://dpanel.cc/#/zh-cn/manual/license">许可</a>
   </nav>
   <div id="app"></div>
   <script>

docs/zh-cn/manual/container/cron.md

@@ -0,0 +1,98 @@
+# 计划任务
+
+> DPanel Version >= 1.4.0
+
+### 添加计划任务
+
+![image-container-1](//cdn.w7.cc/dpanel/container-cron-1.png)
+
+#### 执行容器
+
+因为 DPanel 面板是运行在容器中的，并不具有直接在宿主上运行脚本命令的权限。
+在配置计划任务中，需要指定一个运行命令的容器，默认不指定为在 DPanel 面板容器中运行。
+
+在 DPanel 面板中，可以直接使用 docker 、docker compose、curl、git 相关命令。
+你也可以通过 apk add 命令添加自己需要的命令。
+
+#### 怎么操作宿主机？
+
+在 docker 中的容器，并不是不能操作宿主机，但是赋予的过大的权限会带来很大的安全风险，这也是 docker 守护进程一直被诟病的地方。
+如果你不得不去操作宿主机时，完成后一定要将相关容器销毁。
+
+通过新建特权容器来切换至宿主机的 namespace 中，下面以 busybox 镜像做为演示，新建一个代理容器。
+
+##### 获取宿主机的网络信息
+
+```
+docker run -it --rm --name dpanel-host-proxy --pid host --privileged busybox \
+nsenter --target 1 --net --mount -- /bin/sh -c "ip addr"
+```
+
+##### 获取 docker 的 daemon.json
+
+```
+docker run -it --rm --name dpanel-host-proxy --pid host --privileged busybox \
+nsenter --target 1 --net --mount -- /bin/sh -c "cat /etc/docker/daemon.json"
+```
+
+##### 挂载宿主机根目录
+
+```
+docker run -it --rm --name dpanel-host-proxy -v /:/host busybox \
+ls -al /host
+```
+
+
+#### 执行周期
+
+兼容 Linux 计划任务表达式，扩展了 **秒** 级参数，
+
+```
+* * * * * *     dpanel 中支持的计划任务表达式
+------------------------------------------
+│ │ │ │ │ │
+│ │ │ │ │ └────── 一周当中的某天 (0 - 7) (周日为 0，周一为 1 .... 周六为 6)
+│ │ │ │ └──────── 月份 (1 - 12)
+│ │ │ └────────── 一月当中的某天 (1 - 31)
+│ │ └──────────── 时 (0 - 23)
+│ └────────────── 分 (0 - 59)
+└──────────────── 秒 (0 - 59)
+```
+
+##### 预设周期
+
+面板为了方便大家使用预设了一些常用的周期字段：
+
+- 每月 每月的某日某时某分执行
+- 每周 每周几的某时某分执行
+- 每天 每天的某时某分执行
+- 每小时 每小时的某分执行
+- 每 N 日 从当月的1号开始，隔 N 日的某时某分执行
+- 每 N 时 从当天的0点开始，隔 N 时的某分执行
+- 每 N 分 每小时从0分开始，隔 N 分执行
+- 每 N 秒 每分钟从0秒开始，隔 N 秒执行
+- 自定义 根据上方的计划任务表达式，自定义执行周期
+
+
+#### 等待本次任务执行
+
+开始本项配项后，只有上一次任务执行完成后，才会进行下一次任务。
+避免了单个任务执行时间过长，导致任务重复执行。
+
+#### 保留日志数量
+
+保留执行的结果日志，默认为 10 条。执行时可能会产生大量的结果数据，不建议将此值配置的过多。
+
+#### 执行脚本&环境变量
+
+面板的计划任务允许你在配置脚本的同时，也配置一些环境变量参数。用来将脚本中的一些参数进行替换。
+
+同时你也可以使用【[脚本模板](/zh-cn/manual/setting/cron-template)】的功能用来管理你的常用脚本。
+
+##### 演示
+
+定义以下脚本，并在环境变量中，配置 CONTAINER_NAME 参数即可。
+
+```
+docker restart ${CONTAINER_NAME}
+```

docs/zh-cn/manual/setting/cron-template.md

@@ -0,0 +1,52 @@
+# 脚本模板
+
+> 示例仓库：https://github.com/donknap/dpanel-script-template
+
+用户自定义的脚本模板位于 /dpanel/script 目录中，该目录下的包含多个子目录，每一个子目录表示一组脚本模板。
+
+```
+/dpanel/script
+├─ /template-1                  # template-1 脚本组
+│  ├─ /script-1         
+│  │  └─ data.yaml 
+│  ├─ /script-2        
+│  │  └─ data.yaml
+│  ├─ /script-3              
+│  │  └─ data.yml
+│  └─ ... 
+└─ ....
+```
+
+### 数据定义规范
+
+```yaml
+task: 
+  # 脚本名称
+  name: container-backup
+   # 脚本中文介绍
+  descriptionZh: |
+    备份容器中存储卷或是挂载目录  
+  # 脚本英文介绍
+  descriptionEn: | 
+    Backup the mount directory or volume in the container
+  # 执行的脚本，包含环境变量名，可以换行
+  script: |  
+    BACKUP_FILE_NAME=${CONTAINER_NAME}_$(date +"%Y%m%d%H%M%S").tar
+    docker run -it --rm --name dpanel-task-backup \
+    --volumes-from ${CONTAINER_NAME} \
+    -v ${BACKUP_PATH}:/backup busybox \
+    tar czvf /backup/${BACKUP_FILE_NAME} ${CONTAINER_NAME}
+    echo "备份完成，备份文件位于: ${BACKUP_PATH}/${BACKUP_FILE_NAME}"
+  # 自定义的一些 tag，包含 run-in-dpanel 表示该脚本需要在容器面板中执行
+  tag:  
+    - dpanel
+    - run-in-dpanel
+  # 脚本中用到的环境变量
+  environment: 
+    - name: CONTAINER_NAME
+      labelZh: 容器名称
+      labelEn: container name
+    - name: BACKUP_PATH
+      labelZh: 备份到主机目录
+      labelEn: host backup path
+```