From 06f8514bc16fae892408a96c0067681f70ea629c Mon Sep 17 00:00:00 2001
From: xiaojunnuo <xiaojunnuo@qq.com>
Date: Thu, 15 May 2025 21:54:20 +0800
Subject: [PATCH] =?UTF-8?q?docs(guide):=20=E6=9B=B4=E6=96=B0=E5=B8=B8?=
 =?UTF-8?q?=E8=A7=81=E9=97=AE=E9=A2=98=E8=A7=A3=E7=AD=94?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- 新增 ping 域名的故障排查步骤
- 添加查看容器日志的方法
- 补充 IPv6网络配置的说明
---
 docs/guide/qa/index.md                        | 23 ++++++++++-
 .../certd-client/src/layout/layout-basic.vue  | 12 ++++--
 .../src/vben/layouts/basic/header/header.vue  | 26 ++++++------
 .../vben/layouts/widgets/language-toggle.vue  |  6 +--
 .../widgets/theme-toggle/theme-button.vue     | 12 +++---
 .../widgets/theme-toggle/theme-toggle.vue     | 16 ++++----
 .../shadcn-ui/components/button/button.vue    |  2 +-
 .../components/button/icon-button.vue         | 41 ++++++-------------
 .../modules/plugin/service/plugin-service.ts  | 27 ++++++------
 9 files changed, 85 insertions(+), 80 deletions(-)

diff --git a/docs/guide/qa/index.md b/docs/guide/qa/index.md
index 4c833a74..23257cd1 100644
--- a/docs/guide/qa/index.md
+++ b/docs/guide/qa/index.md
@@ -18,6 +18,14 @@ services:
 #      - 8.8.4.4
 ```
 
+如果仍然有问题,按如下步骤检查是否能够ping通域名
+```shell
+docker exec -it certd /bin/sh
+ping www.baidu.com
+ping gg.px.certd.handfree.work
+ping app.handfree.work
+```
+
 
 ## 2. 连接IPv6超时
 docker-compose 需要放开IPv6网络的配置
@@ -43,4 +51,17 @@ networks:
 
 ## 4. 没有服务器配置文件，请检查是否开启了外网映射！
 宝塔网站证书部署报错：`Error: 没有服务器配置文件，请检查是否开启了外网映射！`    
-解决方案：先手动在宝塔网站中设置一次证书    
\ No newline at end of file
+解决方案：先手动在宝塔网站中设置一次证书    
+
+
+## 5. 如何查看容器日志
+```shell
+docker logs -f --tail 200 certd
+```
+
+
+
+
+
+
+
diff --git a/packages/ui/certd-client/src/layout/layout-basic.vue b/packages/ui/certd-client/src/layout/layout-basic.vue
index da33b3e6..2af00c36 100644
--- a/packages/ui/certd-client/src/layout/layout-basic.vue
+++ b/packages/ui/certd-client/src/layout/layout-basic.vue
@@ -52,6 +52,10 @@ onErrorCaptured(e => {
 onMounted(async () => {
   await settingStore.checkUrlBound();
 });
+
+function goGithub() {
+  window.open("https://github.com/certd/certd");
+}
 </script>
 
 <template>
@@ -63,14 +67,14 @@ onMounted(async () => {
       <LockScreen :avatar @to-login="handleLogout" />
     </template>
     <template #header-right-0>
-      <div class="hover:bg-accent ml-1 mr-2 cursor-pointer rounded-full hidden md:block">
-        <tutorial-button v-if="!settingStore.isComm" class="flex-center header-btn" />
+      <div v-if="!settingStore.isComm" class="hover:bg-accent ml-1 mr-2 cursor-pointer rounded-full hidden md:block">
+        <tutorial-button class="flex-center header-btn" />
       </div>
       <div class="hover:bg-accent ml-1 mr-2 cursor-pointer rounded-full">
         <vip-button class="flex-center header-btn" mode="nav" />
       </div>
-      <div class="hover:bg-accent ml-1 mr-2 cursor-pointer rounded-full">
-        <fs-icon icon="ion:logo-github" />
+      <div v-if="!settingStore.isComm" class="hover:bg-accent ml-1 mr-2 cursor-pointer rounded-full">
+        <fs-button shape="circle" type="text" icon="ion:logo-github" :text="null" @click="goGithub" />
       </div>
     </template>
     <template #footer>
diff --git a/packages/ui/certd-client/src/vben/layouts/basic/header/header.vue b/packages/ui/certd-client/src/vben/layouts/basic/header/header.vue
index 1184b742..4ce85ea4 100644
--- a/packages/ui/certd-client/src/vben/layouts/basic/header/header.vue
+++ b/packages/ui/certd-client/src/vben/layouts/basic/header/header.vue
@@ -18,11 +18,11 @@ interface Props {
 }
 
 defineOptions({
-  name: "LayoutHeader"
+  name: "LayoutHeader",
 });
 
 withDefaults(defineProps<Props>(), {
-  theme: "light"
+  theme: "light",
 });
 
 const emit = defineEmits<{ clearPreferencesAndLogout: [] }>();
@@ -39,42 +39,42 @@ const rightSlots = computed(() => {
   if (preferences.widget.globalSearch) {
     list.push({
       index: REFERENCE_VALUE,
-      name: "global-search"
+      name: "global-search",
     });
   }
 
   if (preferencesButtonPosition.value.header) {
     list.push({
       index: REFERENCE_VALUE + 10,
-      name: "preferences"
+      name: "preferences",
     });
   }
   if (preferences.widget.themeToggle) {
     list.push({
       index: REFERENCE_VALUE + 20,
-      name: "theme-toggle"
+      name: "theme-toggle",
     });
   }
   if (preferences.widget.languageToggle) {
     list.push({
       index: REFERENCE_VALUE + 30,
-      name: "language-toggle"
+      name: "language-toggle",
     });
   }
   if (preferences.widget.fullscreen) {
     list.push({
       index: REFERENCE_VALUE + 40,
-      name: "fullscreen"
+      name: "fullscreen",
     });
   }
   if (preferences.widget.notification) {
     list.push({
       index: REFERENCE_VALUE + 50,
-      name: "notification"
+      name: "notification",
     });
   }
 
-  Object.keys(slots).forEach((key) => {
+  Object.keys(slots).forEach(key => {
     const name = key.split("-");
     if (key.startsWith("header-right")) {
       list.push({ index: Number(name[2]), name: key });
@@ -89,11 +89,11 @@ const leftSlots = computed(() => {
   if (preferences.widget.refresh) {
     list.push({
       index: 0,
-      name: "refresh"
+      name: "refresh",
     });
   }
 
-  Object.keys(slots).forEach((key) => {
+  Object.keys(slots).forEach(key => {
     const name = key.split("-");
     if (key.startsWith("header-left")) {
       list.push({ index: Number(name[2]), name: key });
@@ -108,7 +108,7 @@ function clearPreferencesAndLogout() {
 </script>
 
 <template>
-  <template v-for="slot in leftSlots.filter((item) => item.index < REFERENCE_VALUE)" :key="slot.name">
+  <template v-for="slot in leftSlots.filter(item => item.index < REFERENCE_VALUE)" :key="slot.name">
     <slot :name="slot.name">
       <template v-if="slot.name === 'refresh'">
         <VbenIconButton class="my-0 mr-1 rounded-md" @click="refresh">
@@ -120,7 +120,7 @@ function clearPreferencesAndLogout() {
   <div class="flex-center hidden lg:block">
     <slot name="breadcrumb"></slot>
   </div>
-  <template v-for="slot in leftSlots.filter((item) => item.index > REFERENCE_VALUE)" :key="slot.name">
+  <template v-for="slot in leftSlots.filter(item => item.index > REFERENCE_VALUE)" :key="slot.name">
     <slot :name="slot.name"></slot>
   </template>
   <div :class="`menu-align-${preferences.header.menuAlign}`" class="flex h-full min-w-0 flex-1 items-center">
diff --git a/packages/ui/certd-client/src/vben/layouts/widgets/language-toggle.vue b/packages/ui/certd-client/src/vben/layouts/widgets/language-toggle.vue
index d8598f7e..bfcc9cb0 100644
--- a/packages/ui/certd-client/src/vben/layouts/widgets/language-toggle.vue
+++ b/packages/ui/certd-client/src/vben/layouts/widgets/language-toggle.vue
@@ -9,15 +9,15 @@ import { preferences, updatePreferences } from "/@/vben/preferences";
 import { VbenDropdownRadioMenu, VbenIconButton } from "/@/vben//shadcn-ui";
 
 defineOptions({
-  name: "LanguageToggle"
+  name: "LanguageToggle",
 });
 
 async function handleUpdate(value: string) {
   const locale = value as SupportedLanguagesType;
   updatePreferences({
     app: {
-      locale
-    }
+      locale,
+    },
   });
   await loadLocaleMessages(locale);
 }
diff --git a/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-button.vue b/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-button.vue
index 2f0d594b..540d1a04 100644
--- a/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-button.vue
+++ b/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-button.vue
@@ -11,11 +11,11 @@ interface Props {
 }
 
 defineOptions({
-  name: "ThemeToggleButton"
+  name: "ThemeToggleButton",
 });
 
 const props = withDefaults(defineProps<Props>(), {
-  type: "normal"
+  type: "normal",
 });
 
 const isDark = defineModel<boolean>();
@@ -29,13 +29,13 @@ const bindProps = computed(() => {
 
   return type === "normal"
     ? {
-        variant: "heavy" as const
+        variant: "heavy" as const,
       }
     : {
         class: "rounded-full",
         size: "icon" as const,
         style: { padding: "7px" },
-        variant: "icon" as const
+        variant: "icon" as const,
       };
 });
 
@@ -59,12 +59,12 @@ function toggleTheme(event: MouseEvent) {
     const clipPath = [`circle(0px at ${x}px ${y}px)`, `circle(${endRadius}px at ${x}px ${y}px)`];
     document.documentElement.animate(
       {
-        clipPath: isDark.value ? [...clipPath].reverse() : clipPath
+        clipPath: isDark.value ? [...clipPath].reverse() : clipPath,
       },
       {
         duration: 450,
         easing: "ease-in",
-        pseudoElement: isDark.value ? "::view-transition-old(root)" : "::view-transition-new(root)"
+        pseudoElement: isDark.value ? "::view-transition-old(root)" : "::view-transition-new(root)",
       }
     );
   });
diff --git a/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-toggle.vue b/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-toggle.vue
index 15b5a5db..41cc0060 100644
--- a/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-toggle.vue
+++ b/packages/ui/certd-client/src/vben/layouts/widgets/theme-toggle/theme-toggle.vue
@@ -10,16 +10,16 @@ import { ToggleGroup, ToggleGroupItem, VbenTooltip } from "/@/vben//shadcn-ui";
 import ThemeButton from "./theme-button.vue";
 
 defineOptions({
-  name: "ThemeToggle"
+  name: "ThemeToggle",
 });
 
 withDefaults(defineProps<{ shouldOnHover?: boolean }>(), {
-  shouldOnHover: false
+  shouldOnHover: false,
 });
 
 function handleChange(isDark: boolean) {
   updatePreferences({
-    theme: { mode: isDark ? "dark" : "light" }
+    theme: { mode: isDark ? "dark" : "light" },
   });
 }
 
@@ -29,18 +29,18 @@ const PRESETS = [
   {
     icon: Sun,
     name: "light",
-    title: $t("preferences.theme.light")
+    title: $t("preferences.theme.light"),
   },
   {
     icon: MoonStar,
     name: "dark",
-    title: $t("preferences.theme.dark")
+    title: $t("preferences.theme.dark"),
   },
   {
     icon: SunMoon,
     name: "auto",
-    title: $t("preferences.followSystem")
-  }
+    title: $t("preferences.followSystem"),
+  },
 ];
 </script>
 <template>
@@ -49,7 +49,7 @@ const PRESETS = [
       <template #trigger>
         <ThemeButton :model-value="isDark" type="icon" @update:model-value="handleChange" />
       </template>
-      <ToggleGroup :model-value="preferences.theme.mode" class="gap-2" type="single" variant="outline" @update:model-value="(val) => updatePreferences({ theme: { mode: val as ThemeModeType } })">
+      <ToggleGroup :model-value="preferences.theme.mode" class="gap-2" type="single" variant="outline" @update:model-value="val => updatePreferences({ theme: { mode: val as ThemeModeType } })">
         <ToggleGroupItem v-for="item in PRESETS" :key="item.name" :value="item.name">
           <component :is="item.icon" class="size-5" />
         </ToggleGroupItem>
diff --git a/packages/ui/certd-client/src/vben/shadcn-ui/components/button/button.vue b/packages/ui/certd-client/src/vben/shadcn-ui/components/button/button.vue
index a798382e..746d9bac 100644
--- a/packages/ui/certd-client/src/vben/shadcn-ui/components/button/button.vue
+++ b/packages/ui/certd-client/src/vben/shadcn-ui/components/button/button.vue
@@ -18,7 +18,7 @@ const props = withDefaults(defineProps<Props>(), {
   disabled: false,
   loading: false,
   size: "default",
-  variant: "default"
+  variant: "default",
 });
 
 const isDisabled = computed(() => {
diff --git a/packages/ui/certd-client/src/vben/shadcn-ui/components/button/icon-button.vue b/packages/ui/certd-client/src/vben/shadcn-ui/components/button/icon-button.vue
index 9038e2af..f332e736 100644
--- a/packages/ui/certd-client/src/vben/shadcn-ui/components/button/icon-button.vue
+++ b/packages/ui/certd-client/src/vben/shadcn-ui/components/button/icon-button.vue
@@ -1,13 +1,13 @@
 <script setup lang="ts">
-import type { ButtonVariants } from '../../ui';
-import type { VbenButtonProps } from './button';
+import type { ButtonVariants } from "../../ui";
+import type { VbenButtonProps } from "./button";
 
-import { computed, useSlots } from 'vue';
+import { computed, useSlots } from "vue";
 
-import { cn } from '/@/vben/shared/utils';
+import { cn } from "/@/vben/shared/utils";
 
-import { VbenTooltip } from '../tooltip';
-import VbenButton from './button.vue';
+import { VbenTooltip } from "../tooltip";
+import VbenButton from "./button.vue";
 
 interface Props extends VbenButtonProps {
   class?: any;
@@ -15,7 +15,7 @@ interface Props extends VbenButtonProps {
   onClick?: () => void;
   tooltip?: string;
   tooltipDelayDuration?: number;
-  tooltipSide?: 'bottom' | 'left' | 'right' | 'top';
+  tooltipSide?: "bottom" | "left" | "right" | "top";
   variant?: ButtonVariants;
 }
 
@@ -23,8 +23,8 @@ const props = withDefaults(defineProps<Props>(), {
   disabled: false,
   onClick: () => {},
   tooltipDelayDuration: 200,
-  tooltipSide: 'bottom',
-  variant: 'icon',
+  tooltipSide: "bottom",
+  variant: "icon",
 });
 
 const slots = useSlots();
@@ -33,30 +33,13 @@ const showTooltip = computed(() => !!slots.tooltip || !!props.tooltip);
 </script>
 
 <template>
-  <VbenButton
-    v-if="!showTooltip"
-    :class="cn('rounded-full', props.class)"
-    :disabled="disabled"
-    :variant="variant"
-    size="icon"
-    @click="onClick"
-  >
+  <VbenButton v-if="!showTooltip" :class="cn('rounded-full', props.class)" :disabled="disabled" :variant="variant" size="icon" @click="onClick">
     <slot></slot>
   </VbenButton>
 
-  <VbenTooltip
-    v-else
-    :delay-duration="tooltipDelayDuration"
-    :side="tooltipSide"
-  >
+  <VbenTooltip v-else :delay-duration="tooltipDelayDuration" :side="tooltipSide">
     <template #trigger>
-      <VbenButton
-        :class="cn('rounded-full', props.class)"
-        :disabled="disabled"
-        :variant="variant"
-        size="icon"
-        @click="onClick"
-      >
+      <VbenButton :class="cn('rounded-full', props.class)" :disabled="disabled" :variant="variant" size="icon" @click="onClick">
         <slot></slot>
       </VbenButton>
     </template>
diff --git a/packages/ui/certd-server/src/modules/plugin/service/plugin-service.ts b/packages/ui/certd-server/src/modules/plugin/service/plugin-service.ts
index af762774..c3c94a07 100644
--- a/packages/ui/certd-server/src/modules/plugin/service/plugin-service.ts
+++ b/packages/ui/certd-server/src/modules/plugin/service/plugin-service.ts
@@ -1,16 +1,16 @@
-import {Inject, Provide, Scope, ScopeEnum} from "@midwayjs/core";
-import {BaseService, PageReq} from "@certd/lib-server";
-import {PluginEntity} from "../entity/plugin.js";
-import {InjectEntityModel} from "@midwayjs/typeorm";
-import {Repository} from "typeorm";
-import {isComm} from "@certd/plus-core";
-import {BuiltInPluginService} from "../../pipeline/service/builtin-plugin-service.js";
-import {merge} from "lodash-es";
-import {accessRegistry, notificationRegistry, pluginRegistry} from "@certd/pipeline";
-import {dnsProviderRegistry} from "@certd/plugin-cert";
-import {logger} from "@certd/basic";
+import { Inject, Provide, Scope, ScopeEnum } from "@midwayjs/core";
+import { BaseService, PageReq } from "@certd/lib-server";
+import { PluginEntity } from "../entity/plugin.js";
+import { InjectEntityModel } from "@midwayjs/typeorm";
+import { Repository } from "typeorm";
+import { isComm } from "@certd/plus-core";
+import { BuiltInPluginService } from "../../pipeline/service/builtin-plugin-service.js";
+import { merge } from "lodash-es";
+import { accessRegistry, notificationRegistry, pluginRegistry } from "@certd/pipeline";
+import { dnsProviderRegistry } from "@certd/plugin-cert";
+import { logger } from "@certd/basic";
 import yaml from "js-yaml";
-import {getDefaultAccessPlugin, getDefaultDeployPlugin, getDefaultDnsPlugin} from "./default-plugin.js";
+import { getDefaultAccessPlugin, getDefaultDeployPlugin, getDefaultDnsPlugin } from "./default-plugin.js";
 import fs from "fs";
 import path from "path";
 
@@ -254,9 +254,6 @@ export class PluginService extends BaseService<PluginEntity> {
         }).constructor;
         // const script = await this.compile(plugin.content);
         const script = plugin.content;
-        const {MaoyunClient} = await import("@certd/plugin-plus")
-        const a :any ={}
-        new MaoyunClient(a)
         const getPluginClass = new AsyncFunction(script);
         return await getPluginClass({logger: logger});
       } catch (e) {