Compare commits
13 Commits
6823e35514
...
cb407365b0
Author | SHA1 | Date | |
---|---|---|---|
cb407365b0 | |||
c6ca2507ae | |||
8e66c0fc56 | |||
6bafa4d12d | |||
fdab0fd5bb | |||
bf0add6dc6 | |||
df43c1845e | |||
0beda86667 | |||
4c8334b7bd | |||
25470fc7f8 | |||
41e273ed07 | |||
cca2b53694 | |||
3c359c6a19 |
@@ -2,6 +2,7 @@
|
||||
const { seo } = useAppConfig()
|
||||
|
||||
const { data: navigation } = await useAsyncData('navigation', () => queryCollectionNavigation('docs'))
|
||||
const { data: blogNavigation } = await useAsyncData('blogNavigation', () => queryCollectionNavigation('blog'))
|
||||
const { data: files } = useLazyAsyncData('search', () => queryCollectionSearchSections('docs'), {
|
||||
server: false
|
||||
})
|
||||
@@ -45,6 +46,7 @@ useSeoMeta({
|
||||
})
|
||||
|
||||
provide('navigation', navigation)
|
||||
provide('blogNavigation', blogNavigation)
|
||||
</script>
|
||||
|
||||
<template>
|
||||
|
155
app/components/blog/BlogHeader.vue
Normal file
155
app/components/blog/BlogHeader.vue
Normal file
@@ -0,0 +1,155 @@
|
||||
<script setup lang="ts">
|
||||
// import type { NavigationMenuItem } from '@nuxt/ui'
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('blogNavigation')
|
||||
// 提取 blog 目录下的子目录作为顶级导航
|
||||
const blogNavigation = computed(() => {
|
||||
if (!navigation?.value) return []
|
||||
// 查找 docs 目录
|
||||
const docsItem = navigation.value.find(item => item.title === 'blog' || item.path === '/blog')
|
||||
|
||||
if (!docsItem?.children) return []
|
||||
|
||||
// 返回 docs 目录下的子目录
|
||||
return docsItem.children
|
||||
})
|
||||
|
||||
const isSettingsOpen = ref(false)
|
||||
const isLoginModalOpen = ref(false)
|
||||
const isRegisterModalOpen = ref(false)
|
||||
|
||||
// const { header } = useAppConfig();
|
||||
|
||||
// 定义 props 来接收侧边栏状态和切换函数
|
||||
interface Props {
|
||||
isSidebarOpen?: boolean
|
||||
toggleSidebar?: () => void
|
||||
}
|
||||
|
||||
const Props = withDefaults(defineProps<Props>(), {
|
||||
isSidebarOpen: false,
|
||||
toggleSidebar: () => { }
|
||||
})
|
||||
|
||||
// 登录注册函数
|
||||
const handleLoginRegister = (type: 'login' | 'register') => {
|
||||
if (type === 'login') {
|
||||
isLoginModalOpen.value = true
|
||||
} else if (type === 'register') {
|
||||
isRegisterModalOpen.value = true
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<UHeader
|
||||
toggle-side="left"
|
||||
title="Estel Docs"
|
||||
mode="modal"
|
||||
class="bg-gray-50 dark:bg-gray-900"
|
||||
>
|
||||
<template #title>
|
||||
<h6 />
|
||||
</template>
|
||||
|
||||
<template #body>
|
||||
<LogoPro class="h-5 w-auto mb-4" />
|
||||
<DocsAsideLeftTop />
|
||||
<div class="mt-4 mb-4 border-t border-gray-200 dark:border-gray-700 w-9/10 mx-5" />
|
||||
<UContentNavigation
|
||||
highlight
|
||||
:navigation="blogNavigation"
|
||||
color="primary"
|
||||
type="single"
|
||||
variant="pill"
|
||||
/>
|
||||
</template>
|
||||
|
||||
<template #right>
|
||||
<UContentSearchButton class="lg:hidden" />
|
||||
<UColorModeButton />
|
||||
<button
|
||||
class=" p-2 rounded-md text-gray-500 dark:text-gray-400 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
|
||||
title="页面设置"
|
||||
@click="isSettingsOpen = !isSettingsOpen"
|
||||
>
|
||||
<svg
|
||||
class="w-5 h-5"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
viewBox="0 0 24 24"
|
||||
>
|
||||
<path
|
||||
stroke-linecap="round"
|
||||
stroke-linejoin="round"
|
||||
stroke-width="2"
|
||||
d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"
|
||||
/>
|
||||
<path
|
||||
stroke-linecap="round"
|
||||
stroke-linejoin="round"
|
||||
stroke-width="2"
|
||||
d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"
|
||||
/>
|
||||
</svg>
|
||||
</button>
|
||||
|
||||
<UTooltip
|
||||
text="Open on GitHub"
|
||||
:kbds="['meta', 'G']"
|
||||
>
|
||||
<UButton
|
||||
color="neutral"
|
||||
variant="ghost"
|
||||
to="https://github.com/estel-li"
|
||||
target="_blank"
|
||||
icon="simple-icons-github"
|
||||
aria-label="GitHub"
|
||||
/>
|
||||
</UTooltip>
|
||||
<div class="flex items-center space-x-2">
|
||||
<button
|
||||
class="px-3 py-2 text-sm font-medium text-gray-700 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white transition-colors"
|
||||
@click="handleLoginRegister('login')"
|
||||
>
|
||||
登录
|
||||
</button>
|
||||
<button
|
||||
class="text-sm font-medium text-white bg-primary rounded-md px-3 py-2 hover:bg-primary-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary transition-colors"
|
||||
@click="handleLoginRegister('register')"
|
||||
>
|
||||
注册
|
||||
</button>
|
||||
</div>
|
||||
</template>
|
||||
</UHeader>
|
||||
|
||||
<!-- Theme Settings Panel -->
|
||||
<ThemeSettings
|
||||
:is-open="isSettingsOpen"
|
||||
@close="isSettingsOpen = false"
|
||||
/>
|
||||
|
||||
<!-- 登录模态框 -->
|
||||
<UModal
|
||||
v-model:open="isLoginModalOpen"
|
||||
title="登录"
|
||||
:dismissible="false"
|
||||
>
|
||||
<template #body>
|
||||
<authLogin />
|
||||
</template>
|
||||
</UModal>
|
||||
|
||||
<!-- 注册模态框 -->
|
||||
<UModal
|
||||
v-model:open="isRegisterModalOpen"
|
||||
title="注册"
|
||||
:dismissible="false"
|
||||
>
|
||||
<template #body>
|
||||
<authRegister />
|
||||
</template>
|
||||
</UModal>
|
||||
</template>
|
38
app/components/blog/BlogHero.vue
Normal file
38
app/components/blog/BlogHero.vue
Normal file
@@ -0,0 +1,38 @@
|
||||
<template>
|
||||
<div class="relative w-full h-64 md:h-80 lg:h-96 overflow-hidden rounded-xl">
|
||||
<!-- 背景图片 -->
|
||||
<NuxtImg
|
||||
src="https://lijue-me.oss-cn-chengdu.aliyuncs.com/%E8%83%8C%E6%99%AF.jpg"
|
||||
alt="Blog Hero"
|
||||
class="w-full h-full object-cover"
|
||||
placeholder
|
||||
loading="lazy"
|
||||
sizes="100vw sm:50vw md:33vw"
|
||||
/>
|
||||
|
||||
<!-- 渐变遮罩 -->
|
||||
<!-- <div class="absolute inset-0 bg-gradient-to-r from-black/60 via-black/40 to-transparent"></div> -->
|
||||
|
||||
<!-- 内容区域 -->
|
||||
<!-- <div class="absolute inset-0 flex items-center justify-start p-8">
|
||||
<div class="max-w-2xl">
|
||||
<h1 class="text-4xl md:text-5xl lg:text-6xl font-bold text-white mb-4">
|
||||
博客文章
|
||||
</h1>
|
||||
<p class="text-lg md:text-xl text-gray-200 mb-6">
|
||||
分享技术见解和心得体会
|
||||
</p>
|
||||
<div class="flex items-center gap-4 text-white/80">
|
||||
<div class="flex items-center gap-2">
|
||||
<UIcon name="lucide-pen-tool" size="20" />
|
||||
<span class="text-sm">技术分享</span>
|
||||
</div>
|
||||
<div class="flex items-center gap-2">
|
||||
<UIcon name="lucide-calendar" size="20" />
|
||||
<span class="text-sm">持续更新</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div> -->
|
||||
</div>
|
||||
</template>
|
85
app/components/blog/BlogSidebar.vue
Normal file
85
app/components/blog/BlogSidebar.vue
Normal file
@@ -0,0 +1,85 @@
|
||||
<template>
|
||||
<UPage>
|
||||
<div
|
||||
class="w-64 bg-white dark:bg-gray-900
|
||||
flex flex-col h-screen border-r border-gray-200 dark:border-gray-700
|
||||
overflow-hidden"
|
||||
>
|
||||
<div class="flex-shrink-0 p-4 border-gray-200 dark:border-gray-700">
|
||||
<!-- Logo -->
|
||||
<LogoPro />
|
||||
</div>
|
||||
|
||||
<!-- Search Box -->
|
||||
<div class="p-4 border-gray-200 dark:border-gray-700">
|
||||
<ClientOnly>
|
||||
<UContentSearchButton
|
||||
:collapsed="false"
|
||||
label="搜索文档"
|
||||
class="w-full"
|
||||
color="primary"
|
||||
/>
|
||||
</ClientOnly>
|
||||
</div>
|
||||
|
||||
<!-- 可滚动的导航区域 -->
|
||||
<div class=" h-full overflow-y-auto ">
|
||||
<!-- 导航 Section -->
|
||||
|
||||
<div>
|
||||
<NuxtLink
|
||||
to="/"
|
||||
class="flex items-center px-4 py-2 text-sm font-medium rounded-lg text-gray-700 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-800 hover:shadow-sm transition-all duration-200"
|
||||
:class="{
|
||||
' text-blue-600 dark:text-blue-400 ':
|
||||
useRoute().path === '/'
|
||||
}"
|
||||
>
|
||||
<Icon
|
||||
name="lucide-home"
|
||||
class="text-primary mr-2"
|
||||
size="20"
|
||||
/>
|
||||
站点首页
|
||||
</NuxtLink>
|
||||
<div class="px-2">
|
||||
<DocsAsideLeftTop />
|
||||
</div>
|
||||
</div>
|
||||
|
||||
<!-- 分隔线 -->
|
||||
<div class="mt-4 uppercase tracking-wider border-t border-gray-200 dark:border-gray-700 w-7/9 mx-5" />
|
||||
|
||||
<!-- 文档目录导航 -->
|
||||
<div class="mt-6 flex items-center justify-start pl-4 w-full pb-3">
|
||||
<UContentNavigation
|
||||
highlight
|
||||
:navigation="docsNavigation"
|
||||
color="primary"
|
||||
type="single"
|
||||
variant="pill"
|
||||
trailing-icon="lucide:chevron-right"
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</UPage>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('blogNavigation')
|
||||
|
||||
// 提取 docs 目录下的子目录作为顶级导航
|
||||
const docsNavigation = computed(() => {
|
||||
if (!navigation?.value) return []
|
||||
// 查找 docs 目录
|
||||
const docsItem = navigation.value.find(item => item.title === 'blog' || item.path === '/blog')
|
||||
|
||||
if (!docsItem?.children) return []
|
||||
|
||||
// 返回 docs 目录下的子目录
|
||||
return docsItem.children
|
||||
})
|
||||
</script>
|
117
app/components/blog/indexBlog.vue
Normal file
117
app/components/blog/indexBlog.vue
Normal file
@@ -0,0 +1,117 @@
|
||||
<script setup lang="ts">
|
||||
// 获取 blog 集合的所有文章
|
||||
const { data: articles } = await useAsyncData('blog-articles', () => {
|
||||
return queryCollection('blog')
|
||||
.select('path', 'title', 'description', 'img', 'date')
|
||||
.where('path', 'NOT LIKE', '%navigation%')
|
||||
.all()
|
||||
})
|
||||
|
||||
// 格式化日期
|
||||
const formatDate = (date: string | Date | null | undefined) => {
|
||||
if (!date) return '未知时间'
|
||||
try {
|
||||
const d = new Date(date)
|
||||
return d.toLocaleDateString('zh-CN', {
|
||||
year: 'numeric',
|
||||
month: 'long',
|
||||
day: 'numeric'
|
||||
})
|
||||
} catch {
|
||||
return '未知时间'
|
||||
}
|
||||
}
|
||||
|
||||
// 计算阅读时间(基于文章内容长度估算)
|
||||
// const getReadingTime = (content: string | null | undefined) => {
|
||||
// if (!content) return 1
|
||||
// try {
|
||||
// const wordsPerMinute = 200
|
||||
// const wordCount = String(content).split(/\s+/).length
|
||||
// return Math.max(1, Math.ceil(wordCount / wordsPerMinute))
|
||||
// } catch {
|
||||
// return 1
|
||||
// }
|
||||
// }
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div class="w-full bg-gray-50 dark:bg-gray-900 min-h-screen mt-4">
|
||||
<div class="max-w-4xl mx-auto ">
|
||||
<!-- 文章列表 -->
|
||||
<div class="space-y-6 w-full">
|
||||
<NuxtLink
|
||||
v-for="item in articles"
|
||||
:key="item.path"
|
||||
:to="item.path"
|
||||
class="block w-full"
|
||||
>
|
||||
<article
|
||||
class="pr-4 bg-white dark:bg-gray-800 rounded-lg border border-gray-200 dark:border-gray-700 overflow-hidden hover:shadow-md transition-all duration-200 cursor-pointer group"
|
||||
>
|
||||
<!-- 文章内容布局 -->
|
||||
<div class="flex flex-row">
|
||||
<!-- 图片预览区域 -->
|
||||
<div class="w-32 h-32 md:w-40 md:h-40 mt-2 ml-2 mb-2 md:mr-2 -mr-1 bg-gray-100 dark:bg-gray-700 rounded-xl overflow-hidden">
|
||||
<img
|
||||
:src="item.img || '/images/default-blog.jpg'"
|
||||
:alt="item.title"
|
||||
class="w-full h-full object-contain group-hover:scale-110 transition-transform duration-300"
|
||||
>
|
||||
</div>
|
||||
|
||||
<!-- 文字内容区域 -->
|
||||
<div class="flex-1 p-4 md:p-6">
|
||||
<!-- 文章头部 -->
|
||||
<div class="mb-4">
|
||||
<h2 class="md:text-2xl text-xl font-bold text-gray-900 dark:text-white mb-2 group-hover:text-blue-600 dark:group-hover:text-blue-400 transition-colors">
|
||||
{{ item.title }}
|
||||
</h2>
|
||||
|
||||
<!-- 文章描述 -->
|
||||
<p
|
||||
v-if="item.description"
|
||||
class="text-gray-600 dark:text-gray-300 md:text-sm text-xs line-clamp-2"
|
||||
>
|
||||
{{ item.description }}
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<!-- 文章元信息 -->
|
||||
<div class="flex items-center justify-between text-xs text-gray-500 dark:text-gray-400">
|
||||
<div class="flex items-center gap-4">
|
||||
<!-- 文章时间 -->
|
||||
<div class="flex items-center gap-1">
|
||||
<UIcon
|
||||
name="lucide-clock"
|
||||
size="14"
|
||||
/>
|
||||
<span>{{ formatDate(item.date) }}</span>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</article>
|
||||
</NuxtLink>
|
||||
</div>
|
||||
|
||||
<!-- 空状态 -->
|
||||
<div
|
||||
v-if="!articles || articles.length === 0"
|
||||
class="text-center py-12"
|
||||
>
|
||||
<UIcon
|
||||
name="lucide-file-text"
|
||||
class="mx-auto text-4xl text-gray-400 mb-4"
|
||||
/>
|
||||
<h3 class="text-lg font-medium text-gray-900 dark:text-white mb-2">
|
||||
暂无文章
|
||||
</h3>
|
||||
<p class="text-gray-500 dark:text-gray-400">
|
||||
还没有发布任何博客文章
|
||||
</p>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
@@ -10,15 +10,28 @@ const items = ref<NavigationMenuItem[][]>([
|
||||
target: '_blank'
|
||||
|
||||
},
|
||||
|
||||
{
|
||||
label: '博客',
|
||||
icon: 'lucide-pen-line',
|
||||
to: '/blog'
|
||||
},
|
||||
|
||||
{
|
||||
label: '简单文档',
|
||||
icon: 'lucide-book',
|
||||
to: '/docs'
|
||||
},
|
||||
|
||||
{
|
||||
label: '组件速查',
|
||||
icon: 'lucide-box',
|
||||
to: '/简单文档/components/api'
|
||||
to: '/docs/简单文档/components/api'
|
||||
},
|
||||
{
|
||||
label: '关于',
|
||||
icon: 'lucide-info',
|
||||
to: '/about'
|
||||
to: '/docs/about'
|
||||
}
|
||||
|
||||
]
|
||||
|
155
app/components/docs/DocsHeader.vue
Normal file
155
app/components/docs/DocsHeader.vue
Normal file
@@ -0,0 +1,155 @@
|
||||
<script setup lang="ts">
|
||||
// import type { NavigationMenuItem } from '@nuxt/ui'
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
|
||||
// 提取 docs 目录下的子目录作为顶级导航
|
||||
const docsNavigation = computed(() => {
|
||||
if (!navigation?.value) return []
|
||||
// 查找 docs 目录
|
||||
const docsItem = navigation.value.find(item => item.title === 'docs' || item.path === '/docs')
|
||||
|
||||
if (!docsItem?.children) return []
|
||||
|
||||
// 返回 docs 目录下的子目录
|
||||
return docsItem.children
|
||||
})
|
||||
|
||||
const isSettingsOpen = ref(false)
|
||||
const isLoginModalOpen = ref(false)
|
||||
const isRegisterModalOpen = ref(false)
|
||||
|
||||
// const { header } = useAppConfig();
|
||||
|
||||
// 定义 props 来接收侧边栏状态和切换函数
|
||||
interface Props {
|
||||
isSidebarOpen?: boolean
|
||||
toggleSidebar?: () => void
|
||||
}
|
||||
|
||||
const Props = withDefaults(defineProps<Props>(), {
|
||||
isSidebarOpen: false,
|
||||
toggleSidebar: () => { }
|
||||
})
|
||||
|
||||
// 登录注册函数
|
||||
const handleLoginRegister = (type: 'login' | 'register') => {
|
||||
if (type === 'login') {
|
||||
isLoginModalOpen.value = true
|
||||
} else if (type === 'register') {
|
||||
isRegisterModalOpen.value = true
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<UHeader
|
||||
toggle-side="left"
|
||||
title="Estel Docs"
|
||||
mode="modal"
|
||||
class="bg-gray-50 dark:bg-gray-900"
|
||||
>
|
||||
<template #title>
|
||||
<h6 />
|
||||
</template>
|
||||
|
||||
<template #body>
|
||||
<LogoPro class="h-5 w-auto mb-4" />
|
||||
<DocsAsideLeftTop />
|
||||
<div class="mt-4 mb-4 border-t border-gray-200 dark:border-gray-700 w-9/10 mx-5" />
|
||||
<UContentNavigation
|
||||
highlight
|
||||
:navigation="docsNavigation"
|
||||
color="primary"
|
||||
type="single"
|
||||
variant="pill"
|
||||
/>
|
||||
</template>
|
||||
|
||||
<template #right>
|
||||
<UContentSearchButton class="lg:hidden" />
|
||||
<UColorModeButton />
|
||||
<button
|
||||
class=" p-2 rounded-md text-gray-500 dark:text-gray-400 hover:bg-gray-100 dark:hover:bg-gray-800 transition-colors"
|
||||
title="页面设置"
|
||||
@click="isSettingsOpen = !isSettingsOpen"
|
||||
>
|
||||
<svg
|
||||
class="w-5 h-5"
|
||||
fill="none"
|
||||
stroke="currentColor"
|
||||
viewBox="0 0 24 24"
|
||||
>
|
||||
<path
|
||||
stroke-linecap="round"
|
||||
stroke-linejoin="round"
|
||||
stroke-width="2"
|
||||
d="M10.325 4.317c.426-1.756 2.924-1.756 3.35 0a1.724 1.724 0 002.573 1.066c1.543-.94 3.31.826 2.37 2.37a1.724 1.724 0 001.065 2.572c1.756.426 1.756 2.924 0 3.35a1.724 1.724 0 00-1.066 2.573c.94 1.543-.826 3.31-2.37 2.37a1.724 1.724 0 00-2.572 1.065c-.426 1.756-2.924 1.756-3.35 0a1.724 1.724 0 00-2.573-1.066c-1.543.94-3.31-.826-2.37-2.37a1.724 1.724 0 00-1.065-2.572c-1.756-.426-1.756-2.924 0-3.35a1.724 1.724 0 001.066-2.573c-.94-1.543.826-3.31 2.37-2.37.996.608 2.296.07 2.572-1.065z"
|
||||
/>
|
||||
<path
|
||||
stroke-linecap="round"
|
||||
stroke-linejoin="round"
|
||||
stroke-width="2"
|
||||
d="M15 12a3 3 0 11-6 0 3 3 0 016 0z"
|
||||
/>
|
||||
</svg>
|
||||
</button>
|
||||
|
||||
<UTooltip
|
||||
text="Open on GitHub"
|
||||
:kbds="['meta', 'G']"
|
||||
>
|
||||
<UButton
|
||||
color="neutral"
|
||||
variant="ghost"
|
||||
to="https://github.com/estel-li"
|
||||
target="_blank"
|
||||
icon="simple-icons-github"
|
||||
aria-label="GitHub"
|
||||
/>
|
||||
</UTooltip>
|
||||
<div class="flex items-center space-x-2">
|
||||
<button
|
||||
class="px-3 py-2 text-sm font-medium text-gray-700 dark:text-gray-300 hover:text-gray-900 dark:hover:text-white transition-colors"
|
||||
@click="handleLoginRegister('login')"
|
||||
>
|
||||
登录
|
||||
</button>
|
||||
<button
|
||||
class="text-sm font-medium text-white bg-primary rounded-md px-3 py-2 hover:bg-primary-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-primary transition-colors"
|
||||
@click="handleLoginRegister('register')"
|
||||
>
|
||||
注册
|
||||
</button>
|
||||
</div>
|
||||
</template>
|
||||
</UHeader>
|
||||
|
||||
<!-- Theme Settings Panel -->
|
||||
<ThemeSettings
|
||||
:is-open="isSettingsOpen"
|
||||
@close="isSettingsOpen = false"
|
||||
/>
|
||||
|
||||
<!-- 登录模态框 -->
|
||||
<UModal
|
||||
v-model:open="isLoginModalOpen"
|
||||
title="登录"
|
||||
:dismissible="false"
|
||||
>
|
||||
<template #body>
|
||||
<authLogin />
|
||||
</template>
|
||||
</UModal>
|
||||
|
||||
<!-- 注册模态框 -->
|
||||
<UModal
|
||||
v-model:open="isRegisterModalOpen"
|
||||
title="注册"
|
||||
:dismissible="false"
|
||||
>
|
||||
<template #body>
|
||||
<authRegister />
|
||||
</template>
|
||||
</UModal>
|
||||
</template>
|
@@ -5,36 +5,37 @@ const route = useRoute()
|
||||
const toast = useToast()
|
||||
const { copy, copied } = useClipboard()
|
||||
|
||||
const markdownLink = computed(() => `${window?.location?.origin}/raw${route.path}.md`)
|
||||
const mdcLink = computed(() => `${window?.location?.origin}${decodeURIComponent(route.path)}`)
|
||||
const markdownLink = computed(() => `${window?.location?.origin}/raw${decodeURIComponent(route.path)}.md`)
|
||||
|
||||
const items = [
|
||||
{
|
||||
label: 'Copy Markdown link',
|
||||
label: '复制链接',
|
||||
icon: 'lucide-link',
|
||||
onSelect() {
|
||||
copy(markdownLink.value)
|
||||
copy(mdcLink.value)
|
||||
|
||||
toast.add({
|
||||
title: 'Markdown link copied to clipboard',
|
||||
title: '文档链接已复制到剪贴板',
|
||||
icon: 'lucide-check-circle',
|
||||
color: 'success'
|
||||
})
|
||||
}
|
||||
},
|
||||
{
|
||||
label: 'View as Markdown',
|
||||
label: '查看 Markdown',
|
||||
icon: 'simple-icons:markdown',
|
||||
target: '_blank',
|
||||
to: markdownLink.value
|
||||
},
|
||||
{
|
||||
label: 'Open in ChatGPT',
|
||||
label: '在 ChatGPT 中打开',
|
||||
icon: 'simple-icons:openai',
|
||||
target: '_blank',
|
||||
to: `https://chatgpt.com/?hints=search&q=${encodeURIComponent(`Read ${markdownLink.value} so I can ask questions about it.`)}`
|
||||
},
|
||||
{
|
||||
label: 'Open in Claude',
|
||||
label: '在 Claude 中打开',
|
||||
icon: 'simple-icons:anthropic',
|
||||
target: '_blank',
|
||||
to: `https://claude.ai/new?q=${encodeURIComponent(`Read ${markdownLink.value} so I can ask questions about it.`)}`
|
||||
@@ -45,14 +46,14 @@ const items = [
|
||||
<template>
|
||||
<UButtonGroup size="sm">
|
||||
<UButton
|
||||
label="Copy page"
|
||||
label="复制链接"
|
||||
:icon="copied ? 'lucide-copy-check' : 'lucide-copy'"
|
||||
color="neutral"
|
||||
variant="outline"
|
||||
:ui="{
|
||||
leadingIcon: [copied ? 'text-primary' : 'text-neutral', 'size-3.5']
|
||||
}"
|
||||
@click="copy(markdownLink)"
|
||||
@click="copy(mdcLink)"
|
||||
/>
|
||||
|
||||
<UDropdownMenu
|
||||
|
@@ -32,7 +32,7 @@
|
||||
class="flex items-center px-4 py-2 text-sm font-medium rounded-lg text-gray-700 dark:text-gray-300 hover:bg-gray-50 dark:hover:bg-gray-800 hover:shadow-sm transition-all duration-200"
|
||||
:class="{
|
||||
' text-blue-600 dark:text-blue-400 ':
|
||||
$route.path === '/'
|
||||
useRoute().path === '/'
|
||||
}"
|
||||
>
|
||||
<Icon
|
||||
@@ -54,7 +54,7 @@
|
||||
<div class="mt-6 flex items-center justify-start pl-4 w-full pb-3">
|
||||
<UContentNavigation
|
||||
highlight
|
||||
:navigation="navigation"
|
||||
:navigation="docsNavigation"
|
||||
color="primary"
|
||||
type="single"
|
||||
variant="pill"
|
||||
@@ -70,4 +70,16 @@
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
|
||||
|
||||
// 提取 docs 目录下的子目录作为顶级导航
|
||||
const docsNavigation = computed(() => {
|
||||
if (!navigation?.value) return []
|
||||
// 查找 docs 目录
|
||||
const docsItem = navigation.value.find(item => item.title === 'docs' || item.path === '/docs')
|
||||
|
||||
if (!docsItem?.children) return []
|
||||
|
||||
// 返回 docs 目录下的子目录
|
||||
return docsItem.children
|
||||
})
|
||||
</script>
|
@@ -67,10 +67,14 @@ import type { ContentNavigationItem } from '@nuxt/content'
|
||||
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
|
||||
|
||||
// 计算属性:提取第一级数据
|
||||
// 计算属性:提取docs目录下的第一级数据
|
||||
const firstLevelItems = computed(() => {
|
||||
if (!navigation?.value) return []
|
||||
return navigation.value
|
||||
// 查找docs目录
|
||||
const docsItem = navigation.value.find(item => item.title === 'docs' || item.path === '/docs')
|
||||
if (!docsItem?.children) return []
|
||||
// 返回docs目录下的子目录
|
||||
return docsItem.children
|
||||
.filter(item => item.title && item.path)
|
||||
.map(item => ({
|
||||
...item,
|
@@ -1,9 +1,9 @@
|
||||
<script setup lang="ts">
|
||||
import type { NuxtError } from '#app'
|
||||
|
||||
definePageMeta({
|
||||
layout: 'default'
|
||||
})
|
||||
// definePageMeta({
|
||||
// layout: ''
|
||||
// })
|
||||
|
||||
defineProps<{
|
||||
error: NuxtError
|
||||
|
@@ -8,7 +8,7 @@
|
||||
/>
|
||||
|
||||
<!-- 侧边栏 -->
|
||||
<AppSidebar
|
||||
<BlogSidebar
|
||||
class="fixed top-0 bottom-0 z-50 transition-transform duration-300 ease-in-out"
|
||||
:class="isSidebarOpen ? 'translate-x-0' : '-translate-x-full lg:translate-x-0'"
|
||||
/>
|
||||
@@ -16,7 +16,7 @@
|
||||
<!-- Right Content Area -->
|
||||
<div class="flex-1 lg:ml-64 flex flex-col min-w-0">
|
||||
<!-- Fixed Header -->
|
||||
<AppHeader
|
||||
<BlogHeader
|
||||
:is-sidebar-open="isSidebarOpen"
|
||||
:toggle-sidebar="toggleSidebar"
|
||||
/>
|
@@ -1,22 +1,46 @@
|
||||
<script setup lang="ts">
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<UContainer>
|
||||
<UPage>
|
||||
<template #left>
|
||||
<UPageAside>
|
||||
<UContentNavigation
|
||||
highlight
|
||||
:navigation="navigation"
|
||||
/>
|
||||
</UPageAside>
|
||||
</template>
|
||||
<div class="min-h-screen bg-gray-50 dark:bg-gray-900 flex">
|
||||
<!-- 移动端遮罩层 -->
|
||||
<div
|
||||
v-if="isSidebarOpen"
|
||||
class="fixed inset-0 bg-gray-900/50 z-40 lg:hidden"
|
||||
@click="isSidebarOpen = false"
|
||||
/>
|
||||
|
||||
<slot />
|
||||
</UPage>
|
||||
</UContainer>
|
||||
<!-- 侧边栏 -->
|
||||
<DocsSidebar
|
||||
class="fixed top-0 bottom-0 z-50 transition-transform duration-300 ease-in-out"
|
||||
:class="isSidebarOpen ? 'translate-x-0' : '-translate-x-full lg:translate-x-0'"
|
||||
/>
|
||||
|
||||
<!-- Right Content Area -->
|
||||
<div class="flex-1 lg:ml-64 flex flex-col min-w-0">
|
||||
<!-- Fixed Header -->
|
||||
<DocsHeader
|
||||
:is-sidebar-open="isSidebarOpen"
|
||||
:toggle-sidebar="toggleSidebar"
|
||||
/>
|
||||
|
||||
<!-- Main Content -->
|
||||
<UMain class="flex-1 overflow-y-auto">
|
||||
<div class="mx-auto px-4 sm:px-6 lg:px-8 py-6">
|
||||
<slot />
|
||||
</div>
|
||||
</UMain>
|
||||
|
||||
<!-- Footer -->
|
||||
<AppFooter />
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import { ref } from 'vue'
|
||||
|
||||
const isSidebarOpen = ref(false)
|
||||
|
||||
// 切换侧边栏
|
||||
const toggleSidebar = () => {
|
||||
isSidebarOpen.value = !isSidebarOpen.value
|
||||
}
|
||||
</script>
|
||||
|
@@ -2,9 +2,9 @@
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
import { findPageHeadline } from '#ui-pro/utils/content'
|
||||
|
||||
// definePageMeta({
|
||||
// layout: 'docs'
|
||||
// })
|
||||
definePageMeta({
|
||||
layout: 'blog'
|
||||
})
|
||||
|
||||
const route = useRoute()
|
||||
const appConfig = useAppConfig()
|
||||
@@ -19,21 +19,7 @@ const pageFontSizeClass = computed(() => {
|
||||
})
|
||||
|
||||
// 根据路由参数构建内容路径
|
||||
const path = computed(() => {
|
||||
const slug = route.params.slug
|
||||
|
||||
// 处理 slug 参数
|
||||
if (!slug) {
|
||||
return '/' // 如果没有 slug,返回根路径
|
||||
}
|
||||
|
||||
const pathValue = Array.isArray(slug) ? slug.join('/') : slug
|
||||
|
||||
// 确保路径以 / 开头,不以 / 结尾
|
||||
const normalizedPath = `/${pathValue}`.replace(/\/+$/, '') // 使用 /+ 匹配多个连续的斜杠
|
||||
|
||||
return normalizedPath
|
||||
})
|
||||
const path = computed(() => route.path)
|
||||
|
||||
// URL 解码并验证路径
|
||||
const queryPath = computed(() => {
|
||||
@@ -47,7 +33,7 @@ const queryPath = computed(() => {
|
||||
|
||||
const { data: page } = await useAsyncData(
|
||||
`page-${route.path}`, // 使用更具体的 key
|
||||
() => queryCollection('docs').path(queryPath.value).first(),
|
||||
() => queryCollection('blog').path(decodeURIComponent(path.value)).first(),
|
||||
{
|
||||
default: () => null // 提供默认值
|
||||
}
|
||||
@@ -117,7 +103,7 @@ const links = computed(() => {
|
||||
<template>
|
||||
<UPage
|
||||
v-if="page"
|
||||
:class="pageFontSizeClass"
|
||||
:class="['lg:mr-30 sm:mt-6', pageFontSizeClass]"
|
||||
>
|
||||
<UPageHeader
|
||||
:title="page.title"
|
||||
@@ -180,17 +166,20 @@ const links = computed(() => {
|
||||
v-if="page?.body?.toc?.links?.length"
|
||||
#right
|
||||
>
|
||||
<div class="fixed top-24 right-15 w-auto">
|
||||
<div class="">
|
||||
<UContentToc
|
||||
:title="appConfig.toc?.title"
|
||||
:links="page.body?.toc?.links"
|
||||
:ui="{
|
||||
root: 'fixed w-full xl:right-12 xl:w-64 z-50 bg-white dark:bg-gray-900 lg:border border-gray-200 dark:border-gray-700 rounded-lg lg:shadow-lg lg:mt-5'
|
||||
}"
|
||||
>
|
||||
<template
|
||||
v-if="appConfig.toc?.bottom"
|
||||
#bottom
|
||||
>
|
||||
<div
|
||||
class="hidden lg:block space-y-6 "
|
||||
class=""
|
||||
:class="{ '!mt-5': page.body?.toc?.links?.length }"
|
||||
>
|
||||
<USeparator
|
25
app/pages/blog/index.vue
Normal file
25
app/pages/blog/index.vue
Normal file
@@ -0,0 +1,25 @@
|
||||
<script setup lang="ts">
|
||||
definePageMeta({
|
||||
layout: 'blog'
|
||||
})
|
||||
|
||||
const title = 'Estel Blog'
|
||||
const description = 'Estel Blog'
|
||||
|
||||
useSeoMeta({
|
||||
titleTemplate: '',
|
||||
title,
|
||||
ogTitle: title,
|
||||
description,
|
||||
ogDescription: description,
|
||||
ogImage: 'https://assets.hub.nuxt.com/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RvY3MtdGVtcGxhdGUubnV4dC5kZXYiLCJpYXQiOjE3Mzk0NjM0MTd9.ltVAqPgKG38O01X1zl6MXfrJc55nf9OewXNFjpZ_2JY.jpg?theme=light',
|
||||
twitterImage: 'https://assets.hub.nuxt.com/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RvY3MtdGVtcGxhdGUubnV4dC5kZXYiLCJpYXQiOjE3Mzk0NjM0MTd9.ltVAqPgKG38O01X1zl6MXfrJc55nf9OewXNFjpZ_2JY.jpg?theme=light'
|
||||
})
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
<!-- <BlogHero /> -->
|
||||
<BlogIndexBlog />
|
||||
</div>
|
||||
</template>
|
200
app/pages/docs/[...slug].vue
Normal file
200
app/pages/docs/[...slug].vue
Normal file
@@ -0,0 +1,200 @@
|
||||
<script setup lang="ts">
|
||||
import type { ContentNavigationItem } from '@nuxt/content'
|
||||
import { findPageHeadline } from '#ui-pro/utils/content'
|
||||
|
||||
definePageMeta({
|
||||
layout: 'docs'
|
||||
})
|
||||
|
||||
const route = useRoute()
|
||||
const appConfig = useAppConfig()
|
||||
const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
|
||||
|
||||
// 获取主题系统的字号设置
|
||||
const { selectedFontSize } = useTheme()
|
||||
|
||||
// 计算页面内容的字号类
|
||||
const pageFontSizeClass = computed(() => {
|
||||
return `text-${selectedFontSize.value}`
|
||||
})
|
||||
|
||||
// 根据路由参数构建内容路径
|
||||
const path = computed(() => route.path)
|
||||
|
||||
// URL 解码并验证路径
|
||||
const queryPath = computed(() => {
|
||||
try {
|
||||
return decodeURIComponent(path.value)
|
||||
} catch (error) {
|
||||
console.error('URL decode error:', error)
|
||||
return path.value // 如果解码失败,返回原始路径
|
||||
}
|
||||
})
|
||||
|
||||
const { data: page } = await useAsyncData(
|
||||
`page-${route.path}`, // 使用更具体的 key
|
||||
() => queryCollection('docs').path(decodeURIComponent(path.value)).first(),
|
||||
{
|
||||
default: () => null // 提供默认值
|
||||
}
|
||||
)
|
||||
|
||||
if (!page.value) {
|
||||
throw createError({
|
||||
statusCode: 404,
|
||||
statusMessage: '文档不存在',
|
||||
message: `当前页面不存在,请您检查路径是否正确: ${queryPath.value}`,
|
||||
fatal: true
|
||||
})
|
||||
}
|
||||
|
||||
const { data: surround } = await useAsyncData(`${route.path}-surround`, () => {
|
||||
return queryCollectionItemSurroundings('docs', route.path, {
|
||||
fields: ['description']
|
||||
})
|
||||
})
|
||||
|
||||
const title = page.value.seo?.title || page.value.title
|
||||
const description = page.value.seo?.description || page.value.description
|
||||
|
||||
useSeoMeta({
|
||||
title,
|
||||
ogTitle: title,
|
||||
description,
|
||||
ogDescription: description
|
||||
})
|
||||
|
||||
const headline = computed(() => findPageHeadline(navigation?.value, page.value))
|
||||
|
||||
defineOgImageComponent('Docs', {
|
||||
headline: headline.value
|
||||
})
|
||||
|
||||
const editLink = computed(() => {
|
||||
if (!appConfig.github) {
|
||||
return
|
||||
}
|
||||
|
||||
return [
|
||||
appConfig.github.url,
|
||||
'edit',
|
||||
appConfig.github.branch,
|
||||
appConfig.github.rootDir,
|
||||
'content',
|
||||
`${page.value?.stem}.${page.value?.extension}`
|
||||
].filter(Boolean).join('/')
|
||||
})
|
||||
|
||||
const links = computed(() => {
|
||||
const links = []
|
||||
if (appConfig.toc?.bottom?.edit) {
|
||||
links.push({
|
||||
icon: 'lucide-external-link',
|
||||
label: '编辑页面',
|
||||
to: `${appConfig.toc.bottom.edit}/${page?.value?.stem}.${page?.value?.extension}`,
|
||||
target: '_blank'
|
||||
})
|
||||
}
|
||||
|
||||
return [...links, ...(appConfig.toc?.bottom?.links || [])].filter(Boolean)
|
||||
})
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<UPage
|
||||
v-if="page"
|
||||
:class="['lg:mr-30 sm:mt-6', pageFontSizeClass]"
|
||||
>
|
||||
<UPageHeader
|
||||
:title="page.title"
|
||||
:description="page.description"
|
||||
:headline="headline"
|
||||
:ui="{
|
||||
wrapper: 'flex-row items-center flex-wrap justify-between '
|
||||
}"
|
||||
>
|
||||
<template #links>
|
||||
<UButton
|
||||
v-for="(link, index) in page.links"
|
||||
:key="index"
|
||||
size="sm"
|
||||
v-bind="link"
|
||||
/>
|
||||
|
||||
<DocsPageHeaderLinks />
|
||||
</template>
|
||||
</UPageHeader>
|
||||
|
||||
<UPageBody>
|
||||
<ContentRenderer
|
||||
v-if="page"
|
||||
:value="page"
|
||||
/>
|
||||
|
||||
<USeparator>
|
||||
<div
|
||||
v-if="editLink"
|
||||
class="flex items-center gap-2 text-sm text-muted"
|
||||
>
|
||||
<UButton
|
||||
variant="link"
|
||||
color="neutral"
|
||||
:to="editLink"
|
||||
target="_blank"
|
||||
icon="lucide-pen"
|
||||
:ui="{ leadingIcon: 'size-4' }"
|
||||
>
|
||||
编辑页面
|
||||
</UButton>
|
||||
or
|
||||
<UButton
|
||||
variant="link"
|
||||
color="neutral"
|
||||
:to="`${appConfig.github.url}/issues/new/choose`"
|
||||
target="_blank"
|
||||
icon="lucide-alert-circle"
|
||||
:ui="{ leadingIcon: 'size-4' }"
|
||||
>
|
||||
提交问题
|
||||
</UButton>
|
||||
</div>
|
||||
</USeparator>
|
||||
<UContentSurround :surround="surround" />
|
||||
</UPageBody>
|
||||
|
||||
<template
|
||||
v-if="page?.body?.toc?.links?.length"
|
||||
#right
|
||||
>
|
||||
<div class="">
|
||||
<UContentToc
|
||||
:title="appConfig.toc?.title"
|
||||
:links="page.body?.toc?.links"
|
||||
:ui="{
|
||||
root: 'fixed w-full xl:right-12 xl:w-64 z-50 bg-white dark:bg-gray-900 lg:border border-gray-200 dark:border-gray-700 rounded-lg lg:shadow-lg lg:mt-5'
|
||||
}"
|
||||
>
|
||||
<template
|
||||
v-if="appConfig.toc?.bottom"
|
||||
#bottom
|
||||
>
|
||||
<div
|
||||
class=""
|
||||
:class="{ '!mt-5': page.body?.toc?.links?.length }"
|
||||
>
|
||||
<USeparator
|
||||
v-if="page.body?.toc?.links?.length"
|
||||
type="dashed"
|
||||
/>
|
||||
|
||||
<UPageLinks
|
||||
:title="appConfig.toc.bottom.title"
|
||||
:links="links"
|
||||
/>
|
||||
</div>
|
||||
</template>
|
||||
</UContentToc>
|
||||
</div>
|
||||
</template>
|
||||
</UPage>
|
||||
</template>
|
25
app/pages/docs/index.vue
Normal file
25
app/pages/docs/index.vue
Normal file
@@ -0,0 +1,25 @@
|
||||
<script setup lang="ts">
|
||||
definePageMeta({
|
||||
layout: 'docs'
|
||||
})
|
||||
|
||||
const title = 'Estel Docs'
|
||||
const description = 'Estel Docs'
|
||||
|
||||
useSeoMeta({
|
||||
titleTemplate: '',
|
||||
title,
|
||||
ogTitle: title,
|
||||
description,
|
||||
ogDescription: description,
|
||||
ogImage: 'https://assets.hub.nuxt.com/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RvY3MtdGVtcGxhdGUubnV4dC5kZXYiLCJpYXQiOjE3Mzk0NjM0MTd9.ltVAqPgKG38O01X1zl6MXfrJc55nf9OewXNFjpZ_2JY.jpg?theme=light',
|
||||
twitterImage: 'https://assets.hub.nuxt.com/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RvY3MtdGVtcGxhdGUubnV4dC5kZXYiLCJpYXQiOjE3Mzk0NjM0MTd9.ltVAqPgKG38O01X1zl6MXfrJc55nf9OewXNFjpZ_2JY.jpg?theme=light'
|
||||
})
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
<DocsIndexHero />
|
||||
<DocsIndexCard />
|
||||
</div>
|
||||
</template>
|
@@ -1,25 +1,125 @@
|
||||
<script setup lang="ts">
|
||||
import { useSeoMeta } from '#imports'
|
||||
|
||||
definePageMeta({
|
||||
layout: 'default'
|
||||
layout: 'docs'
|
||||
})
|
||||
|
||||
const title = 'Estel Docs'
|
||||
const description = 'Estel Docs'
|
||||
|
||||
useSeoMeta({
|
||||
titleTemplate: '',
|
||||
title,
|
||||
ogTitle: title,
|
||||
description,
|
||||
ogDescription: description,
|
||||
ogImage: 'https://assets.hub.nuxt.com/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RvY3MtdGVtcGxhdGUubnV4dC5kZXYiLCJpYXQiOjE3Mzk0NjM0MTd9.ltVAqPgKG38O01X1zl6MXfrJc55nf9OewXNFjpZ_2JY.jpg?theme=light',
|
||||
twitterImage: 'https://assets.hub.nuxt.com/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RvY3MtdGVtcGxhdGUubnV4dC5kZXYiLCJpYXQiOjE3Mzk0NjM0MTd9.ltVAqPgKG38O01X1zl6MXfrJc55nf9OewXNFjpZ_2JY.jpg?theme=light'
|
||||
title: 'Estel Docs',
|
||||
description: '简约而强大的文档系统,为技术分享而生',
|
||||
ogTitle: 'Estel Docs',
|
||||
ogDescription: '简约而强大的文档系统,为技术分享而生'
|
||||
})
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<div>
|
||||
<IndexHero />
|
||||
<IndexCard />
|
||||
<div class="min-h-screen bg-gradient-to-br from-blue-50 via-white to-indigo-50 dark:from-gray-900 dark:via-gray-800 dark:to-gray-900">
|
||||
<!-- Hero 区域 -->
|
||||
<div class="max-w-6xl mx-auto px-4 py-20">
|
||||
<!-- 主要内容 -->
|
||||
<div class="text-center mb-16">
|
||||
<h1 class="text-5xl md:text-7xl font-bold text-gray-900 dark:text-white mb-6">
|
||||
Estel Hub
|
||||
</h1>
|
||||
<p class="text-xl md:text-2xl text-gray-600 dark:text-gray-300 mb-8 max-w-3xl mx-auto">
|
||||
简约而强大的文档系统,衍生而出Blog系统,为技术分享而生
|
||||
</p>
|
||||
<p class="text-lg text-gray-500 dark:text-gray-400 mb-12 max-w-2xl mx-auto">
|
||||
基于 Nuxt 4 构建,支持 Markdown 文档管理和博客发布,提供完整的现代化内容管理解决方案
|
||||
</p>
|
||||
</div>
|
||||
|
||||
<!-- 导航卡片 -->
|
||||
<div class="grid md:grid-cols-2 gap-8 max-w-4xl mx-auto">
|
||||
<!-- 文档系统 -->
|
||||
<NuxtLink
|
||||
to="/docs"
|
||||
class="group bg-white dark:bg-gray-800 rounded-2xl p-8 shadow-lg hover:shadow-xl transition-all duration-300 border border-gray-200 dark:border-gray-700"
|
||||
>
|
||||
<div class="text-center">
|
||||
<div class="w-16 h-16 bg-blue-100 dark:bg-blue-900 rounded-full flex items-center justify-center mx-auto mb-6 group-hover:scale-110 transition-transform duration-300">
|
||||
<UIcon
|
||||
name="lucide-book-open"
|
||||
class="text-3xl text-blue-600 dark:text-blue-400"
|
||||
/>
|
||||
</div>
|
||||
<h2 class="text-2xl font-bold text-gray-900 dark:text-white mb-4">
|
||||
文档系统
|
||||
</h2>
|
||||
<p class="text-gray-600 dark:text-gray-300 mb-6">
|
||||
技术文档、API 文档、使用指南,一切尽在掌握
|
||||
</p>
|
||||
<div class="flex items-center justify-center text-blue-600 dark:text-blue-400 group-hover:text-blue-700 dark:group-hover:text-blue-300 transition-colors">
|
||||
<span class="mr-2">开始阅读</span>
|
||||
<UIcon
|
||||
name="lucide-arrow-right"
|
||||
size="20"
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
</NuxtLink>
|
||||
|
||||
<!-- 博客系统 -->
|
||||
<NuxtLink
|
||||
to="/blog"
|
||||
class="group bg-white dark:bg-gray-800 rounded-2xl p-8 shadow-lg hover:shadow-xl transition-all duration-300 border border-gray-200 dark:border-gray-700"
|
||||
>
|
||||
<div class="text-center">
|
||||
<div class="w-16 h-16 bg-green-100 dark:bg-green-900 rounded-full flex items-center justify-center mx-auto mb-6 group-hover:scale-110 transition-transform duration-300">
|
||||
<UIcon
|
||||
name="lucide-pen-tool"
|
||||
class="text-3xl text-green-600 dark:text-green-400"
|
||||
/>
|
||||
</div>
|
||||
<h2 class="text-2xl font-bold text-gray-900 dark:text-white mb-4">
|
||||
博客系统
|
||||
</h2>
|
||||
<p class="text-gray-600 dark:text-gray-300 mb-6">
|
||||
技术分享、心得体会、生活感悟,记录每一个精彩瞬间
|
||||
</p>
|
||||
<div class="flex items-center justify-center text-green-600 dark:text-green-400 group-hover:text-green-700 dark:group-hover:text-green-300 transition-colors">
|
||||
<span class="mr-2">开始阅读</span>
|
||||
<UIcon
|
||||
name="lucide-arrow-right"
|
||||
size="20"
|
||||
/>
|
||||
</div>
|
||||
</div>
|
||||
</NuxtLink>
|
||||
</div>
|
||||
|
||||
<!-- 底部信息 -->
|
||||
<div class="text-center mt-16">
|
||||
<div class="flex items-center justify-center gap-8 text-sm text-gray-500 dark:text-gray-400">
|
||||
<div class="flex items-center gap-2">
|
||||
<UIcon
|
||||
name="lucide-github"
|
||||
size="16"
|
||||
/>
|
||||
<a
|
||||
href="https://github.com/estel-li/estel-docs"
|
||||
target="_blank"
|
||||
class="hover:text-gray-700 dark:hover:text-gray-200 transition-colors"
|
||||
>
|
||||
GitHub
|
||||
</a>
|
||||
</div>
|
||||
<div class="flex items-center gap-2">
|
||||
<UIcon
|
||||
name="lucide-globe"
|
||||
size="16"
|
||||
/>
|
||||
<a
|
||||
href="https://lijue.me"
|
||||
target="_blank"
|
||||
class="hover:text-gray-700 dark:hover:text-gray-200 transition-colors"
|
||||
>
|
||||
个人博客
|
||||
</a>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</div>
|
||||
</template>
|
||||
|
118
app/pages/raw/[...slug].vue
Normal file
118
app/pages/raw/[...slug].vue
Normal file
@@ -0,0 +1,118 @@
|
||||
<script setup lang="ts">
|
||||
// import type { ContentNavigationItem } from '@nuxt/content'
|
||||
// import { findPageHeadline } from '#ui-pro/utils/content'
|
||||
|
||||
const route = useRoute()
|
||||
// const appConfig = useAppConfig()
|
||||
// const navigation = inject<Ref<ContentNavigationItem[]>>('navigation')
|
||||
|
||||
// 获取主题系统的字号设置
|
||||
// const { selectedFontSize } = useTheme()
|
||||
|
||||
// 计算页面内容的字号类
|
||||
// const pageFontSizeClass = computed(() => {
|
||||
// return `text-${selectedFontSize.value}`
|
||||
// })
|
||||
|
||||
// 根据路由参数构建内容路径
|
||||
const path = computed(() => {
|
||||
const slug = route.params.slug
|
||||
|
||||
// 处理 slug 参数
|
||||
if (!slug) {
|
||||
return '/' // 如果没有 slug,返回根路径
|
||||
}
|
||||
|
||||
const pathValue = Array.isArray(slug) ? slug.join('/') : slug
|
||||
|
||||
// 确保路径以 / 开头,不以 / 结尾,并过滤掉文件扩展名
|
||||
const normalizedPath = `/${pathValue}`
|
||||
.replace(/\/+$/, '') // 使用 /+ 匹配多个连续的斜杠
|
||||
.replace(/\.(md|markdown|txt|html|vue)$/i, '') // 过滤掉常见的文件扩展名
|
||||
|
||||
return normalizedPath
|
||||
})
|
||||
|
||||
// URL 解码并验证路径
|
||||
const queryPath = computed(() => {
|
||||
try {
|
||||
return decodeURIComponent(path.value)
|
||||
} catch (error) {
|
||||
console.error('URL decode error:', error)
|
||||
return path.value // 如果解码失败,返回原始路径
|
||||
}
|
||||
})
|
||||
|
||||
// 根据路径判断查询的集合
|
||||
const collection = computed(() => {
|
||||
return queryPath.value.startsWith('/blog') ? 'blog' : 'docs'
|
||||
})
|
||||
|
||||
const { data: page } = await useAsyncData(
|
||||
`page-${route.path}`, // 使用更具体的 key
|
||||
() => queryCollection(collection.value).path(queryPath.value).first(),
|
||||
{
|
||||
default: () => null // 提供默认值
|
||||
}
|
||||
)
|
||||
|
||||
if (!page.value) {
|
||||
throw createError({
|
||||
statusCode: 404,
|
||||
statusMessage: '文档不存在',
|
||||
message: `当前页面不存在,请您检查路径是否正确: ${queryPath.value}`,
|
||||
fatal: true
|
||||
})
|
||||
}
|
||||
|
||||
// 复制状态
|
||||
const isCopied = ref(false)
|
||||
|
||||
// 复制全文功能
|
||||
const copyFullText = async () => {
|
||||
if (!page.value?.rawbody) {
|
||||
return
|
||||
}
|
||||
|
||||
try {
|
||||
await navigator.clipboard.writeText(page.value.rawbody)
|
||||
// 设置复制成功状态
|
||||
isCopied.value = true
|
||||
// 2秒后重置状态
|
||||
setTimeout(() => {
|
||||
isCopied.value = false
|
||||
}, 2000)
|
||||
} catch (error) {
|
||||
console.error('复制失败:', error)
|
||||
}
|
||||
}
|
||||
</script>
|
||||
|
||||
<template>
|
||||
<UPage>
|
||||
<!-- 复制按钮 -->
|
||||
<div class="mb-4 flex justify-start">
|
||||
<UButton
|
||||
:icon="isCopied ? 'lucide-check' : 'lucide-copy'"
|
||||
variant="solid"
|
||||
size="sm"
|
||||
@click="copyFullText"
|
||||
>
|
||||
{{ isCopied ? '已复制' : '复制全文' }}
|
||||
</UButton>
|
||||
</div>
|
||||
|
||||
<!-- 原始内容显示区域 -->
|
||||
<div
|
||||
class="bg-gray-50 dark:bg-gray-900 rounded-lg p-4 overflow-auto"
|
||||
style="user-select: text; -webkit-user-select: text; -moz-user-select: text; -ms-user-select: text;"
|
||||
>
|
||||
<pre
|
||||
class="whitespace-pre-wrap break-words text-sm"
|
||||
style="user-select: text; -webkit-user-select: text; -moz-user-select: text; -ms-user-select: text;"
|
||||
>
|
||||
{{ page?.rawbody }}
|
||||
</pre>
|
||||
</div>
|
||||
</UPage>
|
||||
</template>
|
@@ -5,10 +5,29 @@ export default defineContentConfig({
|
||||
docs: defineCollection({
|
||||
type: 'page',
|
||||
source: {
|
||||
include: '**',
|
||||
include: 'docs/**',
|
||||
exclude: ['/web/**']
|
||||
},
|
||||
schema: z.object({
|
||||
rawbody: z.string(),
|
||||
links: z.array(z.object({
|
||||
label: z.string(),
|
||||
icon: z.string(),
|
||||
to: z.string(),
|
||||
target: z.string().optional()
|
||||
})).optional()
|
||||
})
|
||||
}),
|
||||
blog: defineCollection({
|
||||
type: 'page',
|
||||
source: {
|
||||
include: 'blog/**',
|
||||
exclude: ['/web/**']
|
||||
},
|
||||
schema: z.object({
|
||||
rawbody: z.string(),
|
||||
img: z.string(),
|
||||
date: z.string(),
|
||||
links: z.array(z.object({
|
||||
label: z.string(),
|
||||
icon: z.string(),
|
||||
|
3
content/blog/1.技术栈/.navigation.yml
Normal file
3
content/blog/1.技术栈/.navigation.yml
Normal file
@@ -0,0 +1,3 @@
|
||||
title: 技术栈
|
||||
description: 记录日常开发中遇到的技术问题和解决方案
|
||||
icon: lucide-code
|
883
content/blog/1.技术栈/01.GROK3-and-Deepseek.md
Normal file
883
content/blog/1.技术栈/01.GROK3-and-Deepseek.md
Normal file
@@ -0,0 +1,883 @@
|
||||
---
|
||||
title: GROK3 and Deepseek
|
||||
description: Grok3 和 Deepseek 的对比
|
||||
date: 2025-05-12
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250806105153532.png
|
||||
navigation:
|
||||
icon: lucide-brain
|
||||
---
|
||||
|
||||
### GROK3 and Deepseek
|
||||
测试了GROK3,简单让做一个HTML小游戏,与R1对比
|
||||
GROK3界面处理略好,满足所有要求,无BUG。
|
||||
R1界面略有瑕疵,基本满足所有要求,除了有小BUG。
|
||||
|
||||
提示词:
|
||||
>> 题目:编写一个“打地鼠”网页小游戏
|
||||
|
||||
需求描述:
|
||||
设计一个基于HTML的“打地鼠”(Whack-a-Mole)小游戏,玩家需要在规定时间内点击随机出现的“地鼠”来得分。游戏需要包含以下功能和要求:
|
||||
页面布局:
|
||||
游戏区域是一个3x3的网格(共9个格子),每个格子是一个方形的“洞”。
|
||||
页面顶部显示当前得分(Score)和剩余时间(Time Left)。
|
||||
页面底部有一个“开始游戏”(Start Game)的按钮。
|
||||
游戏逻辑:
|
||||
点击“开始游戏”按钮后,游戏开始,初始时间为30秒。
|
||||
每隔一段随机时间(0.5秒到1.5秒之间),一个“地鼠”会随机出现在某个格子中,持续显示1秒后消失。
|
||||
玩家点击出现的“地鼠”可以得分,每只地鼠加1分。
|
||||
如果点击空白格子,不扣分也不加分。
|
||||
游戏时间结束后,停止地鼠出现,并弹窗显示最终得分,同时提供“再玩一次”的选项。
|
||||
样式要求:
|
||||
游戏区域居中,背景为浅灰色。
|
||||
每个格子为100x100像素,带有圆角边框,初始为土黄色(#d2b48c)。
|
||||
地鼠出现时,格子背景变为绿色(#90ee90),并显示文字“鼠!”(字体大小30px,居中)。
|
||||
得分和时间使用清晰的大字体(建议20px以上),颜色为深蓝色。
|
||||
“开始游戏”按钮为蓝色背景,白色文字,悬停时变亮。
|
||||
技术要求:
|
||||
使用纯HTML、CSS和JavaScript实现,不依赖外部库。
|
||||
代码注释清晰,说明每个部分的功能。
|
||||
确保游戏逻辑无明显bug,例如地鼠不会同时出现在多个格子。
|
||||
提示词:
|
||||
HTML结构:包含游戏容器、得分显示、时间显示、格子网格和按钮。
|
||||
CSS样式:网格布局、格子样式、地鼠出现时的动态效果、按钮交互样式。
|
||||
JavaScript逻辑:随机生成地鼠、计时器、得分计算、游戏状态管理、弹窗提示。
|
||||
输出要求:
|
||||
请一次性提供完整的HTML文件代码(包括HTML、CSS和JavaScript),代码需可直接保存为.html文件并在浏览器中运行。代码中需包含注释,体现逻辑清晰度和编程能力。
|
||||
|
||||
GROK3:
|
||||
```
|
||||
<!DOCTYPE html>
|
||||
|
||||
<html lang="zh-CN">
|
||||
|
||||
<head>
|
||||
|
||||
<meta charset="UTF-8">
|
||||
|
||||
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
||||
|
||||
<title>打地鼠小游戏</title>
|
||||
|
||||
<style>
|
||||
|
||||
/* 整体页面样式 */
|
||||
|
||||
body {
|
||||
|
||||
display: flex;
|
||||
|
||||
flex-direction: column;
|
||||
|
||||
align-items: center;
|
||||
|
||||
justify-content: center;
|
||||
|
||||
height: 100vh;
|
||||
|
||||
margin: 0;
|
||||
|
||||
font-family: Arial, sans-serif;
|
||||
|
||||
background-color: #f0f0f0;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 顶部得分和时间显示 */
|
||||
|
||||
.info {
|
||||
|
||||
display: flex;
|
||||
|
||||
justify-content: space-between;
|
||||
|
||||
width: 320px;
|
||||
|
||||
margin-bottom: 20px;
|
||||
|
||||
}
|
||||
|
||||
.info span {
|
||||
|
||||
font-size: 24px;
|
||||
|
||||
color: #00008b; /* 深蓝色 */
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 游戏区域网格 */
|
||||
|
||||
.game-board {
|
||||
|
||||
display: grid;
|
||||
|
||||
grid-template-columns: repeat(3, 100px);
|
||||
|
||||
grid-gap: 10px;
|
||||
|
||||
background-color: #d3d3d3; /* 浅灰色背景 */
|
||||
|
||||
padding: 10px;
|
||||
|
||||
border-radius: 10px;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 每个格子样式 */
|
||||
|
||||
.hole {
|
||||
|
||||
width: 100px;
|
||||
|
||||
height: 100px;
|
||||
|
||||
background-color: #d2b48c; /* 土黄色 */
|
||||
|
||||
border-radius: 10px;
|
||||
|
||||
display: flex;
|
||||
|
||||
align-items: center;
|
||||
|
||||
justify-content: center;
|
||||
|
||||
font-size: 30px;
|
||||
|
||||
color: #000;
|
||||
|
||||
cursor: pointer;
|
||||
|
||||
transition: background-color 0.2s;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 地鼠出现时的样式 */
|
||||
|
||||
.hole.mole {
|
||||
|
||||
background-color: #90ee90; /* 绿色 */
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 开始按钮样式 */
|
||||
|
||||
.start-btn {
|
||||
|
||||
margin-top: 20px;
|
||||
|
||||
padding: 10px 20px;
|
||||
|
||||
font-size: 18px;
|
||||
|
||||
color: #fff;
|
||||
|
||||
background-color: #4682b4; /* 蓝色 */
|
||||
|
||||
border: none;
|
||||
|
||||
border-radius: 5px;
|
||||
|
||||
cursor: pointer;
|
||||
|
||||
transition: background-color 0.3s;
|
||||
|
||||
}
|
||||
|
||||
.start-btn:hover {
|
||||
|
||||
background-color: #5f9ea0; /* 悬停时变亮 */
|
||||
|
||||
}
|
||||
|
||||
</style>
|
||||
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<!-- 顶部信息 -->
|
||||
|
||||
<div class="info">
|
||||
|
||||
<span id="score">得分: 0</span>
|
||||
|
||||
<span id="time-left">剩余时间: 30</span>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
<!-- 游戏区域 -->
|
||||
|
||||
<div class="game-board" id="gameBoard">
|
||||
|
||||
<!-- 9个格子 -->
|
||||
|
||||
<div class="hole" data-id="0"></div>
|
||||
|
||||
<div class="hole" data-id="1"></div>
|
||||
|
||||
<div class="hole" data-id="2"></div>
|
||||
|
||||
<div class="hole" data-id="3"></div>
|
||||
|
||||
<div class="hole" data-id="4"></div>
|
||||
|
||||
<div class="hole" data-id="5"></div>
|
||||
|
||||
<div class="hole" data-id="6"></div>
|
||||
|
||||
<div class="hole" data-id="7"></div>
|
||||
|
||||
<div class="hole" data-id="8"></div>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
<!-- 开始按钮 -->
|
||||
|
||||
<button class="start-btn" id="startBtn">开始游戏</button>
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
|
||||
// 获取DOM元素
|
||||
|
||||
const scoreDisplay = document.getElementById('score');
|
||||
|
||||
const timeLeftDisplay = document.getElementById('time-left');
|
||||
|
||||
const gameBoard = document.getElementById('gameBoard');
|
||||
|
||||
const startBtn = document.getElementById('startBtn');
|
||||
|
||||
const holes = document.querySelectorAll('.hole');
|
||||
|
||||
|
||||
|
||||
// 游戏状态变量
|
||||
|
||||
let score = 0;
|
||||
|
||||
let timeLeft = 30;
|
||||
|
||||
let gameActive = false;
|
||||
|
||||
let moleTimer = null;
|
||||
|
||||
let countdownTimer = null;
|
||||
|
||||
|
||||
|
||||
// 初始化游戏
|
||||
|
||||
function initGame() {
|
||||
|
||||
score = 0;
|
||||
|
||||
timeLeft = 30;
|
||||
|
||||
gameActive = false;
|
||||
|
||||
scoreDisplay.textContent = `得分: ${score}`;
|
||||
|
||||
timeLeftDisplay.textContent = `剩余时间: ${timeLeft}`;
|
||||
|
||||
clearInterval(moleTimer);
|
||||
|
||||
clearInterval(countdownTimer);
|
||||
|
||||
holes.forEach(hole => {
|
||||
|
||||
hole.classList.remove('mole');
|
||||
|
||||
hole.textContent = '';
|
||||
|
||||
});
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 随机选择一个格子显示地鼠
|
||||
|
||||
function showMole() {
|
||||
|
||||
if (!gameActive) return;
|
||||
|
||||
|
||||
|
||||
// 移除之前的地鼠
|
||||
|
||||
holes.forEach(hole => {
|
||||
|
||||
hole.classList.remove('mole');
|
||||
|
||||
hole.textContent = '';
|
||||
|
||||
});
|
||||
|
||||
|
||||
|
||||
// 随机选择一个格子
|
||||
|
||||
const randomHole = holes[Math.floor(Math.random() * holes.length)];
|
||||
|
||||
randomHole.classList.add('mole');
|
||||
|
||||
randomHole.textContent = '鼠!';
|
||||
|
||||
|
||||
|
||||
// 1秒后隐藏地鼠
|
||||
|
||||
setTimeout(() => {
|
||||
|
||||
randomHole.classList.remove('mole');
|
||||
|
||||
randomHole.textContent = '';
|
||||
|
||||
}, 1000);
|
||||
|
||||
|
||||
|
||||
// 随机间隔后再次显示地鼠
|
||||
|
||||
const randomInterval = Math.random() * 1000 + 500; // 0.5到1.5秒
|
||||
|
||||
moleTimer = setTimeout(showMole, randomInterval);
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 点击格子的事件
|
||||
|
||||
function hitMole(e) {
|
||||
|
||||
const hole = e.target;
|
||||
|
||||
if (hole.classList.contains('mole')) {
|
||||
|
||||
score++;
|
||||
|
||||
scoreDisplay.textContent = `得分: ${score}`;
|
||||
|
||||
hole.classList.remove('mole');
|
||||
|
||||
hole.textContent = '';
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 开始游戏
|
||||
|
||||
function startGame() {
|
||||
|
||||
if (gameActive) return; // 防止重复开始
|
||||
|
||||
initGame();
|
||||
|
||||
gameActive = true;
|
||||
|
||||
startBtn.disabled = true;
|
||||
|
||||
|
||||
|
||||
// 开始倒计时
|
||||
|
||||
countdownTimer = setInterval(() => {
|
||||
|
||||
timeLeft--;
|
||||
|
||||
timeLeftDisplay.textContent = `剩余时间: ${timeLeft}`;
|
||||
|
||||
if (timeLeft <= 0) {
|
||||
|
||||
endGame();
|
||||
|
||||
}
|
||||
|
||||
}, 1000);
|
||||
|
||||
|
||||
|
||||
// 开始地鼠出现
|
||||
|
||||
showMole();
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 游戏结束
|
||||
|
||||
function endGame() {
|
||||
|
||||
gameActive = false;
|
||||
|
||||
clearInterval(moleTimer);
|
||||
|
||||
clearInterval(countdownTimer);
|
||||
|
||||
startBtn.disabled = false;
|
||||
|
||||
alert(`游戏结束!你的得分是: ${score}\n点击“确定”再玩一次!`);
|
||||
|
||||
initGame();
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 事件绑定
|
||||
|
||||
startBtn.addEventListener('click', startGame);
|
||||
|
||||
holes.forEach(hole => hole.addEventListener('click', hitMole));
|
||||
|
||||
|
||||
|
||||
// 初始化游戏状态
|
||||
|
||||
initGame();
|
||||
|
||||
</script>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
```
|
||||
|
||||
R1:
|
||||
```
|
||||
<!DOCTYPE html>
|
||||
|
||||
<html lang="zh-CN">
|
||||
|
||||
<head>
|
||||
|
||||
<meta charset="UTF-8">
|
||||
|
||||
<title>打地鼠 - Whack a Mole</title>
|
||||
|
||||
<style>
|
||||
|
||||
/* 页面整体样式 */
|
||||
|
||||
body {
|
||||
|
||||
font-family: Arial, sans-serif;
|
||||
|
||||
display: flex;
|
||||
|
||||
flex-direction: column;
|
||||
|
||||
align-items: center;
|
||||
|
||||
background-color: #f0f0f0;
|
||||
|
||||
margin: 0;
|
||||
|
||||
min-height: 100vh;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 游戏信息显示区域 */
|
||||
|
||||
.game-info {
|
||||
|
||||
margin: 20px 0;
|
||||
|
||||
font-size: 24px;
|
||||
|
||||
color: #00008b;
|
||||
|
||||
display: flex;
|
||||
|
||||
gap: 30px;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 游戏主容器(3x3网格) */
|
||||
|
||||
#game-board {
|
||||
|
||||
display: grid;
|
||||
|
||||
grid-template-columns: repeat(3, 100px);
|
||||
|
||||
gap: 10px;
|
||||
|
||||
background-color: #cccccc;
|
||||
|
||||
padding: 20px;
|
||||
|
||||
border-radius: 10px;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 单个地鼠洞样式 */
|
||||
|
||||
.hole {
|
||||
|
||||
width: 100px;
|
||||
|
||||
height: 100px;
|
||||
|
||||
background-color: #d2b48c;
|
||||
|
||||
border-radius: 8px;
|
||||
|
||||
cursor: pointer;
|
||||
|
||||
display: flex;
|
||||
|
||||
justify-content: center;
|
||||
|
||||
align-items: center;
|
||||
|
||||
font-size: 0; /* 初始隐藏文字 */
|
||||
|
||||
transition: background-color 0.2s;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 地鼠出现时的样式 */
|
||||
|
||||
.hole.active {
|
||||
|
||||
background-color: #90ee90;
|
||||
|
||||
font-size: 30px; /* 显示文字 */
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
/* 开始游戏按钮 */
|
||||
|
||||
#start-btn {
|
||||
|
||||
margin-top: 30px;
|
||||
|
||||
padding: 12px 30px;
|
||||
|
||||
background-color: #0000ff;
|
||||
|
||||
color: white;
|
||||
|
||||
border: none;
|
||||
|
||||
border-radius: 5px;
|
||||
|
||||
cursor: pointer;
|
||||
|
||||
font-size: 18px;
|
||||
|
||||
transition: background-color 0.2s;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
#start-btn:hover {
|
||||
|
||||
background-color: #3333ff;
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
#start-btn:disabled {
|
||||
|
||||
background-color: #888888;
|
||||
|
||||
cursor: not-allowed;
|
||||
|
||||
}
|
||||
|
||||
</style>
|
||||
|
||||
</head>
|
||||
|
||||
<body>
|
||||
|
||||
<!-- 游戏信息显示 -->
|
||||
|
||||
<div class="game-info">
|
||||
|
||||
<div>得分:<span id="score">0</span></div>
|
||||
|
||||
<div>剩余时间:<span id="timer">30</span>秒</div>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
<!-- 游戏主区域 -->
|
||||
|
||||
<div id="game-board">
|
||||
|
||||
<!-- 生成9个地鼠洞 -->
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
<div class="hole"></div>
|
||||
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
<!-- 控制按钮 -->
|
||||
|
||||
<button id="start-btn">开始游戏</button>
|
||||
|
||||
|
||||
|
||||
<script>
|
||||
|
||||
// 游戏全局变量
|
||||
|
||||
let score = 0;
|
||||
|
||||
let timeLeft = 30;
|
||||
|
||||
let gameActive = false;
|
||||
|
||||
let moleTimer = null;
|
||||
|
||||
let countdownTimer = null;
|
||||
|
||||
|
||||
|
||||
// DOM元素引用
|
||||
|
||||
const holes = document.querySelectorAll('.hole');
|
||||
|
||||
const scoreDisplay = document.getElementById('score');
|
||||
|
||||
const timerDisplay = document.getElementById('timer');
|
||||
|
||||
const startBtn = document.getElementById('start-btn');
|
||||
|
||||
|
||||
|
||||
// 初始化点击事件监听
|
||||
|
||||
holes.forEach(hole => {
|
||||
|
||||
hole.addEventListener('click', () => {
|
||||
|
||||
if (!gameActive) return;
|
||||
|
||||
// 点击有效的地鼠
|
||||
|
||||
if (hole.classList.contains('active')) {
|
||||
|
||||
score++;
|
||||
|
||||
scoreDisplay.textContent = score;
|
||||
|
||||
hole.classList.remove('active');
|
||||
|
||||
hole.textContent = '';
|
||||
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
});
|
||||
|
||||
|
||||
|
||||
// 开始游戏按钮功能
|
||||
|
||||
startBtn.addEventListener('click', () => {
|
||||
|
||||
if (!gameActive) {
|
||||
|
||||
startGame();
|
||||
|
||||
}
|
||||
|
||||
});
|
||||
|
||||
|
||||
|
||||
// 游戏主逻辑
|
||||
|
||||
function startGame() {
|
||||
|
||||
// 重置游戏状态
|
||||
|
||||
gameActive = true;
|
||||
|
||||
score = 0;
|
||||
|
||||
timeLeft = 30;
|
||||
|
||||
scoreDisplay.textContent = score;
|
||||
|
||||
timerDisplay.textContent = timeLeft;
|
||||
|
||||
startBtn.disabled = true;
|
||||
|
||||
|
||||
|
||||
// 清除已有定时器
|
||||
|
||||
clearInterval(countdownTimer);
|
||||
|
||||
clearTimeout(moleTimer);
|
||||
|
||||
|
||||
|
||||
// 启动倒计时
|
||||
|
||||
countdownTimer = setInterval(() => {
|
||||
|
||||
timeLeft--;
|
||||
|
||||
timerDisplay.textContent = timeLeft;
|
||||
|
||||
if (timeLeft <= 0) {
|
||||
|
||||
endGame();
|
||||
|
||||
}
|
||||
|
||||
}, 1000);
|
||||
|
||||
|
||||
|
||||
// 首次生成地鼠
|
||||
|
||||
scheduleMole();
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 随机生成地鼠
|
||||
|
||||
function showMole() {
|
||||
|
||||
// 查找所有非活动状态的洞
|
||||
|
||||
const availableHoles = Array.from(holes).filter(hole => !hole.classList.contains('active'));
|
||||
|
||||
if (availableHoles.length > 0) {
|
||||
|
||||
const randomHole = availableHoles[Math.floor(Math.random() * availableHoles.length)];
|
||||
|
||||
randomHole.classList.add('active');
|
||||
|
||||
randomHole.textContent = '鼠!';
|
||||
|
||||
// 自动隐藏地鼠
|
||||
|
||||
setTimeout(() => {
|
||||
|
||||
randomHole.classList.remove('active');
|
||||
|
||||
randomHole.textContent = '';
|
||||
|
||||
}, 1000);
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 调度下一个地鼠生成
|
||||
|
||||
function scheduleMole() {
|
||||
|
||||
if (!gameActive) return;
|
||||
|
||||
// 随机间隔(0.5-1.5秒)
|
||||
|
||||
const delay = Math.random() * 1000 + 500;
|
||||
|
||||
moleTimer = setTimeout(() => {
|
||||
|
||||
showMole();
|
||||
|
||||
scheduleMole();
|
||||
|
||||
}, delay);
|
||||
|
||||
}
|
||||
|
||||
|
||||
|
||||
// 结束游戏处理
|
||||
|
||||
function endGame() {
|
||||
|
||||
gameActive = false;
|
||||
|
||||
clearInterval(countdownTimer);
|
||||
|
||||
clearTimeout(moleTimer);
|
||||
|
||||
startBtn.disabled = false;
|
||||
|
||||
|
||||
|
||||
// 显示最终得分
|
||||
|
||||
const restart = confirm(`游戏结束!最终得分:${score}\n再玩一次?`);
|
||||
|
||||
if (restart) {
|
||||
|
||||
startGame();
|
||||
|
||||
}
|
||||
|
||||
}
|
||||
|
||||
</script>
|
||||
|
||||
</body>
|
||||
|
||||
</html>
|
||||
```
|
136
content/blog/1.技术栈/02.Iperf3 万兆网络打流测试指南.md
Normal file
136
content/blog/1.技术栈/02.Iperf3 万兆网络打流测试指南.md
Normal file
@@ -0,0 +1,136 @@
|
||||
---
|
||||
title: Iperf3 万兆网络打流测试指南
|
||||
description: Iperf3 万兆网络打流测试指南
|
||||
date: 2025-05-13
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250615184111247.png
|
||||
navigation:
|
||||
icon: lucide-network
|
||||
---
|
||||
|
||||
> 🔍 **文档说明**: 本文记录基于水星S106E Pro交换机的万兆网络Iperf3性能测试,涵盖设备连接、测试参数配置及结果分析。适用于**网络性能测试初学者**及**运维人员**。
|
||||
|
||||
## 技术TAG
|
||||
`#Iperf3` `#万兆网络测试` `#交换机配置` `#AQC113网卡` `#网络性能分析`
|
||||
|
||||
---
|
||||
|
||||
## 一、测试环境配置
|
||||
### 设备拓扑图
|
||||
```mermaid
|
||||
graph LR
|
||||
A[MacBook Air M4] -- 雷电/万兆电口 --> B[水星S106E Pro<br>万兆光口]
|
||||
B -- 万兆光口 --> C[PVE服务器<br>CX4121A网卡]
|
||||
```
|
||||
|
||||
### 硬件清单
|
||||
| **设备** | **规格** | **作用** |
|
||||
|---------------------|-----------------------------------------|-----------------------|
|
||||
| 主测试端 | MacBook Air M4 + 雷电万兆网卡(AQC113) | Iperf3 Client端 |
|
||||
| 交换机 | 水星S106E Pro | 万兆光/电转换枢纽 |
|
||||
| 光转电模块 | AQR113光转电模块 | 连接交换机万兆光口 |
|
||||
| 被测服务端 | NAS (12500T+Q670) + CX4121A万兆网卡 | Iperf3 Server端 |
|
||||
| 辅助设备 | 超六类网线/光纤跳线(按需) | 物理链路连接 |
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 二、Iperf3安装与配置
|
||||
### 1. macOS端安装(Client)
|
||||
```bash
|
||||
# 通过Homebrew安装iperf3
|
||||
brew install iperf3
|
||||
|
||||
# 启动服务端监听(可选本地验证)
|
||||
iperf3 -s -p 5201
|
||||
```
|
||||
|
||||
### 2. PVE服务端安装(Server)
|
||||
```bash
|
||||
# Debian系系统安装
|
||||
apt update && apt install iperf3 -y
|
||||
|
||||
# 启动服务端后台监听
|
||||
iperf3 -s -D -p 5201
|
||||
```
|
||||
> ⚠️ **防火墙注意**: 确保5201端口开放
|
||||
> `ufw allow 5201/tcp` (Debian/Ubuntu)
|
||||
> `firewall-cmd --add-port=5201/tcp --permanent` (CentOS)
|
||||
```
|
||||
|
||||
## 三、典型测试场景
|
||||
### 场景1:TCP带宽测试(默认参数)
|
||||
```bash
|
||||
# Client端执行(MacBook)
|
||||
iperf3 -c <Server_IP> -p 5201 -t 60
|
||||
|
||||
# 参数说明:
|
||||
# -c : 服务端IP地址
|
||||
# -t : 测试持续时间(秒)
|
||||
```
|
||||
|
||||
### 场景2:多线程UDP压力测试
|
||||
```bash
|
||||
iperf3 -c <Server_IP> -p 5201 -u -b 10G -P 4
|
||||
|
||||
# 参数说明:
|
||||
# -u : 使用UDP协议
|
||||
# -b : 指定带宽(10G速率)
|
||||
# -P : 并行线程数
|
||||
```
|
||||
|
||||
|
||||
### 场景3:双向流量测试
|
||||
```bash
|
||||
# 同时测试上行+下行
|
||||
iperf3 -c <Server_IP> -p 5201 --bidir
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 四、测试结果分析要点
|
||||
### 关键性能指标
|
||||
| **字段** | **健康值范围** | **异常排查方向** |
|
||||
|------------------|-------------------------|------------------------|
|
||||
| Bandwidth | >9.5Gbps (万兆场景) | 网卡协商/模块兼容性 |
|
||||
| Jitter | <1ms (UDP测试) | 交换机缓存/线缆质量 |
|
||||
| Packet Loss | 0% | 缓冲区设置/CPU性能 |
|
||||
| TCP Retransmits | <0.1% | TCP窗口/MTU配置 |
|
||||
|
||||
> 💡 **优化建议**:
|
||||
> 1. 使用`-w`调整TCP窗口大小(例如`-w 8M`)
|
||||
> 2. 尝试`--omit N`跳过初始N秒不稳定数据
|
||||
> 3. 添加`-J`参数获取JSON格式结构化结果
|
||||
|
||||
---
|
||||
|
||||
## 五、常见问题解决
|
||||
### ❌ 问题1:协商速率降级至1Gbps
|
||||
```bash
|
||||
# 检查网卡协商状态(MacOS)
|
||||
ifconfig enX | grep media
|
||||
|
||||
# 解决方案:
|
||||
1. 更换光模块/AOC线缆排除物理故障
|
||||
2. 检查交换机端口配置(禁用节能模式)
|
||||
```
|
||||
|
||||
### ❌ 问题2:测试中突发丢包
|
||||
```bash
|
||||
# 动态查看QoS统计(PVE服务器)
|
||||
ethtool -S enpXX | grep -E 'drop|error'
|
||||
|
||||
# 解决方案:
|
||||
1. 调整网卡缓冲区:ethtool -G enpXX rx/tx 4096
|
||||
2. 减少并发线程总数(-P参数)
|
||||
```
|
||||
|
||||

|
||||
*(示意图:实际连接需确保光模块端口匹配)*
|
||||
|
||||
> 📌 **经验总结**:水星S106E Pro需关闭"绿色节能"功能,避免AQC113因节能策略降速。PVE虚拟机环境建议使用SR-IOV直通网卡,减少虚拟化层开销。
|
||||
|
||||
---
|
||||
|
||||
**测试文档版本**: v1.1
|
||||
**更新日期**: 2023-12-15
|
||||
**测试工具版本**: iperf 3.16 (macOS)/iperf 3.7 (Linux)
|
213
content/blog/1.技术栈/03.Debian 12 云服务器初始安全设置与优化指南.md
Normal file
213
content/blog/1.技术栈/03.Debian 12 云服务器初始安全设置与优化指南.md
Normal file
@@ -0,0 +1,213 @@
|
||||
---
|
||||
title: Debian 12 云服务器初始安全设置与优化指南
|
||||
description: Debian 12 云服务器初始安全设置与优化指南
|
||||
date: 2025-05-15
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250615184027376.png
|
||||
navigation:
|
||||
icon: lucide-server
|
||||
---
|
||||
> 🔒 **文档说明**:本文针对新部署的 Debian 12 云服务器,提供必做的安全加固与性能优化配置清单。适用于**运维人员**及**Linux初学者**,可有效防御 90% 的常见攻击向量。
|
||||
|
||||
## 技术TAG
|
||||
`#Debian12安全设置` `#Linux加固` `#服务器优化` `#云服务器安全` `#SSH加固`
|
||||
|
||||
---
|
||||
|
||||
## 一、初始登录与用户安全
|
||||
### 1. 创建替代root的用户
|
||||
```bash
|
||||
# 创建管理员用户(示例用户名为 sysadmin)
|
||||
adduser sysadmin
|
||||
usermod -aG sudo sysadmin
|
||||
|
||||
# 验证新用户sudo权限
|
||||
su - sysadmin
|
||||
sudo whoami # 应返回root
|
||||
```
|
||||
|
||||
### 2. 禁用root SSH登录
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
|
||||
# 修改以下配置:
|
||||
PermitRootLogin no
|
||||
PasswordAuthentication no # 强制使用密钥登录
|
||||
```
|
||||
|
||||
> ⚠️ **关键提示**:
|
||||
> 1. 操作前必须配置好SSH密钥,否则会锁定服务器
|
||||
> 2. 执行后重载服务:`sudo systemctl reload ssh`
|
||||
|
||||
---
|
||||
|
||||
## 二、防火墙配置
|
||||
### UFW基础设置
|
||||
```bash
|
||||
# 安装UFW
|
||||
sudo apt install ufw -y
|
||||
|
||||
# 默认策略
|
||||
sudo ufw default deny incoming
|
||||
sudo ufw default allow outgoing
|
||||
|
||||
# 允许端口(按需开放)
|
||||
sudo ufw allow 22/tcp # SSH
|
||||
sudo ufw allow 80/tcp # HTTP
|
||||
sudo ufw allow 443/tcp # HTTPS
|
||||
|
||||
# 启用防火墙
|
||||
sudo ufw enable
|
||||
sudo ufw status verbose # 验证规则
|
||||
```
|
||||
|
||||
### 端口安全技巧
|
||||
```bash
|
||||
# 更改SSH端口(可选)
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
# 修改: Port 2222 # 改为非标准端口
|
||||
|
||||
# 仅允许特定IP访问SSH
|
||||
sudo ufw allow proto tcp from 192.168.1.100 to any port 22
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、系统更新与自动维护
|
||||
### 初始全面更新
|
||||
```bash
|
||||
sudo apt update && sudo apt full-upgrade -y
|
||||
sudo apt autoremove && sudo apt clean
|
||||
```
|
||||
|
||||
### 配置自动安全更新
|
||||
```bash
|
||||
sudo apt install unattended-upgrades apt-listchanges
|
||||
|
||||
# 启用配置
|
||||
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||
|
||||
# 验证状态:
|
||||
sudo systemctl status unattended-upgrades
|
||||
```
|
||||
|
||||
> 🔧 **配置文件优化** (`/etc/apt/apt.conf.d/50unattended-upgrades`):
|
||||
> ```json
|
||||
> Unattended-Upgrade::Remove-Unused-Dependencies "true";
|
||||
> Unattended-Upgrade::Automatic-Reboot "true";
|
||||
> Unattended-Upgrade::Automatic-Reboot-Time "03:00";
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## 四、安全加固关键措施
|
||||
### 1. 启用基础入侵防护
|
||||
```bash
|
||||
# 安装fail2ban
|
||||
sudo apt install fail2ban -y
|
||||
|
||||
# 配置SSH防护
|
||||
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
|
||||
sudo nano /etc/fail2ban/jail.local
|
||||
```
|
||||
```ini
|
||||
[sshd]
|
||||
enabled = true
|
||||
maxretry = 3
|
||||
bantime = 1h
|
||||
```
|
||||
|
||||
### 2. 内核安全加固
|
||||
```bash
|
||||
# 安装安全组件
|
||||
sudo apt install linux-hardened apparmor apparmor-utils -y
|
||||
|
||||
# 启用AppArmor
|
||||
sudo apparmor_status
|
||||
sudo aa-enforce /etc/apparmor.d/* # 强制所有配置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、性能优化设置
|
||||
### 1. 交换空间优化
|
||||
```bash
|
||||
# 调整Swappiness值(推荐10-30)
|
||||
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
|
||||
|
||||
# 启用Zswap压缩缓存(内存<8GB时尤其有效)
|
||||
echo 'zswap.enabled=1' | sudo tee -a /etc/sysctl.conf
|
||||
```
|
||||
|
||||
### 2. 文件描述符与进程优化
|
||||
```bash
|
||||
# 提高系统限制
|
||||
sudo nano /etc/security/limits.conf
|
||||
```
|
||||
```conf
|
||||
* soft nofile 65535
|
||||
* hard nofile 65535
|
||||
* soft nproc 65535
|
||||
* hard nproc 65535
|
||||
```
|
||||
|
||||
### 3. 日志管理(防止占满磁盘)
|
||||
```bash
|
||||
# 安装日志轮询工具
|
||||
sudo apt install logrotate -y
|
||||
|
||||
# 手动压缩现有大日志
|
||||
sudo find /var/log -size +100M -exec truncate -s 10M {} \;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、审计与监控
|
||||
### 安装基础监控组件
|
||||
```bash
|
||||
sudo apt install sysstat htop net-tools tree ncdu
|
||||
|
||||
# 启用sysstat数据收集
|
||||
sudo sed -i 's/false/true/g' /etc/default/sysstat
|
||||
sudo systemctl enable --now sysstat
|
||||
```
|
||||
|
||||
### 关键审计命令
|
||||
```bash
|
||||
# 检查异常登录:
|
||||
sudo lastb -a | head -20
|
||||
|
||||
# 检查SUID文件:
|
||||
sudo find / -perm /4000 -ls
|
||||
|
||||
# 列出开放端口:
|
||||
sudo ss -tunlp
|
||||
```
|
||||
|
||||
> 📊 **推荐可视化工具**:
|
||||
> - Cockpit (轻量级Web面板):`sudo apt install cockpit`
|
||||
> - Netdata (实时监控):`bash <(curl -Ss https://my-netdata.io/kickstart.sh)`
|
||||
|
||||
---
|
||||
|
||||
**最终安全检查清单**:
|
||||
```bash
|
||||
echo "[+] SSH 配置"
|
||||
sudo sshd -t && grep -E "PermitRoot|PasswordAuth" /etc/ssh/sshd_config
|
||||
|
||||
echo "[+] 防火墙状态"
|
||||
sudo ufw status
|
||||
|
||||
echo "[]+ 更新状态"
|
||||
sudo unattended-upgrades --dry-run
|
||||
```
|
||||

|
||||
*(安全层示意图:网络防火墙→系统加固→应用防护)*
|
||||
|
||||
> 🔐 **维护建议**:
|
||||
> 1. 每月执行:`sudo lynis audit system` (安装:`apt install lynis`)
|
||||
> 2. 每季度更新所有SSL证书,即使未到期
|
||||
> 3. 使用自动配置管理工具(如Ansible)维护服务器状态
|
||||
|
||||
**文档版本**: v1.2
|
||||
**测试环境**: Debian 12.5 (Kernel 6.1.x) 云服务器
|
||||
**最后更新**: 2024-06-15
|
213
content/blog/1.技术栈/04.Dify + Supabase:打造带数据库的AI问答机器人.md
Normal file
213
content/blog/1.技术栈/04.Dify + Supabase:打造带数据库的AI问答机器人.md
Normal file
@@ -0,0 +1,213 @@
|
||||
---
|
||||
title: Dify + Supabase:打造带数据库的AI问答机器人
|
||||
description: 基于Dify和Supabase的AI问答机器人
|
||||
date: 2025-05-18
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250807175904733.png
|
||||
navigation:
|
||||
icon: simple-icons:reactbootstrap
|
||||
---
|
||||
> 🔒 **文档说明**:本文针对新部署的 Debian 12 云服务器,提供必做的安全加固与性能优化配置清单。适用于**运维人员**及**Linux初学者**,可有效防御 90% 的常见攻击向量。
|
||||
|
||||
## 技术TAG
|
||||
`#Debian12安全设置` `#Linux加固` `#服务器优化` `#云服务器安全` `#SSH加固`
|
||||
|
||||
---
|
||||
|
||||
## 一、初始登录与用户安全
|
||||
### 1. 创建替代root的用户
|
||||
```bash
|
||||
# 创建管理员用户(示例用户名为 sysadmin)
|
||||
adduser sysadmin
|
||||
usermod -aG sudo sysadmin
|
||||
|
||||
# 验证新用户sudo权限
|
||||
su - sysadmin
|
||||
sudo whoami # 应返回root
|
||||
```
|
||||
|
||||
### 2. 禁用root SSH登录
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
|
||||
# 修改以下配置:
|
||||
PermitRootLogin no
|
||||
PasswordAuthentication no # 强制使用密钥登录
|
||||
```
|
||||
|
||||
> ⚠️ **关键提示**:
|
||||
> 1. 操作前必须配置好SSH密钥,否则会锁定服务器
|
||||
> 2. 执行后重载服务:`sudo systemctl reload ssh`
|
||||
|
||||
---
|
||||
|
||||
## 二、防火墙配置
|
||||
### UFW基础设置
|
||||
```bash
|
||||
# 安装UFW
|
||||
sudo apt install ufw -y
|
||||
|
||||
# 默认策略
|
||||
sudo ufw default deny incoming
|
||||
sudo ufw default allow outgoing
|
||||
|
||||
# 允许端口(按需开放)
|
||||
sudo ufw allow 22/tcp # SSH
|
||||
sudo ufw allow 80/tcp # HTTP
|
||||
sudo ufw allow 443/tcp # HTTPS
|
||||
|
||||
# 启用防火墙
|
||||
sudo ufw enable
|
||||
sudo ufw status verbose # 验证规则
|
||||
```
|
||||
|
||||
### 端口安全技巧
|
||||
```bash
|
||||
# 更改SSH端口(可选)
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
# 修改: Port 2222 # 改为非标准端口
|
||||
|
||||
# 仅允许特定IP访问SSH
|
||||
sudo ufw allow proto tcp from 192.168.1.100 to any port 22
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、系统更新与自动维护
|
||||
### 初始全面更新
|
||||
```bash
|
||||
sudo apt update && sudo apt full-upgrade -y
|
||||
sudo apt autoremove && sudo apt clean
|
||||
```
|
||||
|
||||
### 配置自动安全更新
|
||||
```bash
|
||||
sudo apt install unattended-upgrades apt-listchanges
|
||||
|
||||
# 启用配置
|
||||
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||
|
||||
# 验证状态:
|
||||
sudo systemctl status unattended-upgrades
|
||||
```
|
||||
|
||||
> 🔧 **配置文件优化** (`/etc/apt/apt.conf.d/50unattended-upgrades`):
|
||||
> ```json
|
||||
> Unattended-Upgrade::Remove-Unused-Dependencies "true";
|
||||
> Unattended-Upgrade::Automatic-Reboot "true";
|
||||
> Unattended-Upgrade::Automatic-Reboot-Time "03:00";
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## 四、安全加固关键措施
|
||||
### 1. 启用基础入侵防护
|
||||
```bash
|
||||
# 安装fail2ban
|
||||
sudo apt install fail2ban -y
|
||||
|
||||
# 配置SSH防护
|
||||
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
|
||||
sudo nano /etc/fail2ban/jail.local
|
||||
```
|
||||
```ini
|
||||
[sshd]
|
||||
enabled = true
|
||||
maxretry = 3
|
||||
bantime = 1h
|
||||
```
|
||||
|
||||
### 2. 内核安全加固
|
||||
```bash
|
||||
# 安装安全组件
|
||||
sudo apt install linux-hardened apparmor apparmor-utils -y
|
||||
|
||||
# 启用AppArmor
|
||||
sudo apparmor_status
|
||||
sudo aa-enforce /etc/apparmor.d/* # 强制所有配置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、性能优化设置
|
||||
### 1. 交换空间优化
|
||||
```bash
|
||||
# 调整Swappiness值(推荐10-30)
|
||||
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
|
||||
|
||||
# 启用Zswap压缩缓存(内存<8GB时尤其有效)
|
||||
echo 'zswap.enabled=1' | sudo tee -a /etc/sysctl.conf
|
||||
```
|
||||
|
||||
### 2. 文件描述符与进程优化
|
||||
```bash
|
||||
# 提高系统限制
|
||||
sudo nano /etc/security/limits.conf
|
||||
```
|
||||
```conf
|
||||
* soft nofile 65535
|
||||
* hard nofile 65535
|
||||
* soft nproc 65535
|
||||
* hard nproc 65535
|
||||
```
|
||||
|
||||
### 3. 日志管理(防止占满磁盘)
|
||||
```bash
|
||||
# 安装日志轮询工具
|
||||
sudo apt install logrotate -y
|
||||
|
||||
# 手动压缩现有大日志
|
||||
sudo find /var/log -size +100M -exec truncate -s 10M {} \;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、审计与监控
|
||||
### 安装基础监控组件
|
||||
```bash
|
||||
sudo apt install sysstat htop net-tools tree ncdu
|
||||
|
||||
# 启用sysstat数据收集
|
||||
sudo sed -i 's/false/true/g' /etc/default/sysstat
|
||||
sudo systemctl enable --now sysstat
|
||||
```
|
||||
|
||||
### 关键审计命令
|
||||
```bash
|
||||
# 检查异常登录:
|
||||
sudo lastb -a | head -20
|
||||
|
||||
# 检查SUID文件:
|
||||
sudo find / -perm /4000 -ls
|
||||
|
||||
# 列出开放端口:
|
||||
sudo ss -tunlp
|
||||
```
|
||||
|
||||
> 📊 **推荐可视化工具**:
|
||||
> - Cockpit (轻量级Web面板):`sudo apt install cockpit`
|
||||
> - Netdata (实时监控):`bash <(curl -Ss https://my-netdata.io/kickstart.sh)`
|
||||
|
||||
---
|
||||
|
||||
**最终安全检查清单**:
|
||||
```bash
|
||||
echo "[+] SSH 配置"
|
||||
sudo sshd -t && grep -E "PermitRoot|PasswordAuth" /etc/ssh/sshd_config
|
||||
|
||||
echo "[+] 防火墙状态"
|
||||
sudo ufw status
|
||||
|
||||
echo "[]+ 更新状态"
|
||||
sudo unattended-upgrades --dry-run
|
||||
```
|
||||

|
||||
*(安全层示意图:网络防火墙→系统加固→应用防护)*
|
||||
|
||||
> 🔐 **维护建议**:
|
||||
> 1. 每月执行:`sudo lynis audit system` (安装:`apt install lynis`)
|
||||
> 2. 每季度更新所有SSL证书,即使未到期
|
||||
> 3. 使用自动配置管理工具(如Ansible)维护服务器状态
|
||||
|
||||
**文档版本**: v1.2
|
||||
**测试环境**: Debian 12.5 (Kernel 6.1.x) 云服务器
|
||||
**最后更新**: 2024-06-15
|
213
content/blog/1.技术栈/05.安装 VS Code到浏览器 -- Code Server copy.md
Normal file
213
content/blog/1.技术栈/05.安装 VS Code到浏览器 -- Code Server copy.md
Normal file
@@ -0,0 +1,213 @@
|
||||
---
|
||||
title: 安装 VS Code到浏览器 -- Code Server
|
||||
description: 在浏览器中安装 VS Code
|
||||
date: 2025-05-23
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250616220449750.png
|
||||
navigation:
|
||||
icon: simple-icons:visualstudiocode
|
||||
---
|
||||
> 🔒 **文档说明**:本文针对新部署的 Debian 12 云服务器,提供必做的安全加固与性能优化配置清单。适用于**运维人员**及**Linux初学者**,可有效防御 90% 的常见攻击向量。
|
||||
|
||||
## 技术TAG
|
||||
`#Debian12安全设置` `#Linux加固` `#服务器优化` `#云服务器安全` `#SSH加固`
|
||||
|
||||
---
|
||||
|
||||
## 一、初始登录与用户安全
|
||||
### 1. 创建替代root的用户
|
||||
```bash
|
||||
# 创建管理员用户(示例用户名为 sysadmin)
|
||||
adduser sysadmin
|
||||
usermod -aG sudo sysadmin
|
||||
|
||||
# 验证新用户sudo权限
|
||||
su - sysadmin
|
||||
sudo whoami # 应返回root
|
||||
```
|
||||
|
||||
### 2. 禁用root SSH登录
|
||||
```bash
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
|
||||
# 修改以下配置:
|
||||
PermitRootLogin no
|
||||
PasswordAuthentication no # 强制使用密钥登录
|
||||
```
|
||||
|
||||
> ⚠️ **关键提示**:
|
||||
> 1. 操作前必须配置好SSH密钥,否则会锁定服务器
|
||||
> 2. 执行后重载服务:`sudo systemctl reload ssh`
|
||||
|
||||
---
|
||||
|
||||
## 二、防火墙配置
|
||||
### UFW基础设置
|
||||
```bash
|
||||
# 安装UFW
|
||||
sudo apt install ufw -y
|
||||
|
||||
# 默认策略
|
||||
sudo ufw default deny incoming
|
||||
sudo ufw default allow outgoing
|
||||
|
||||
# 允许端口(按需开放)
|
||||
sudo ufw allow 22/tcp # SSH
|
||||
sudo ufw allow 80/tcp # HTTP
|
||||
sudo ufw allow 443/tcp # HTTPS
|
||||
|
||||
# 启用防火墙
|
||||
sudo ufw enable
|
||||
sudo ufw status verbose # 验证规则
|
||||
```
|
||||
|
||||
### 端口安全技巧
|
||||
```bash
|
||||
# 更改SSH端口(可选)
|
||||
sudo nano /etc/ssh/sshd_config
|
||||
# 修改: Port 2222 # 改为非标准端口
|
||||
|
||||
# 仅允许特定IP访问SSH
|
||||
sudo ufw allow proto tcp from 192.168.1.100 to any port 22
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 三、系统更新与自动维护
|
||||
### 初始全面更新
|
||||
```bash
|
||||
sudo apt update && sudo apt full-upgrade -y
|
||||
sudo apt autoremove && sudo apt clean
|
||||
```
|
||||
|
||||
### 配置自动安全更新
|
||||
```bash
|
||||
sudo apt install unattended-upgrades apt-listchanges
|
||||
|
||||
# 启用配置
|
||||
sudo dpkg-reconfigure -plow unattended-upgrades
|
||||
|
||||
# 验证状态:
|
||||
sudo systemctl status unattended-upgrades
|
||||
```
|
||||
|
||||
> 🔧 **配置文件优化** (`/etc/apt/apt.conf.d/50unattended-upgrades`):
|
||||
> ```json
|
||||
> Unattended-Upgrade::Remove-Unused-Dependencies "true";
|
||||
> Unattended-Upgrade::Automatic-Reboot "true";
|
||||
> Unattended-Upgrade::Automatic-Reboot-Time "03:00";
|
||||
> ```
|
||||
|
||||
---
|
||||
|
||||
## 四、安全加固关键措施
|
||||
### 1. 启用基础入侵防护
|
||||
```bash
|
||||
# 安装fail2ban
|
||||
sudo apt install fail2ban -y
|
||||
|
||||
# 配置SSH防护
|
||||
sudo cp /etc/fail2ban/jail.conf /etc/fail2ban/jail.local
|
||||
sudo nano /etc/fail2ban/jail.local
|
||||
```
|
||||
```ini
|
||||
[sshd]
|
||||
enabled = true
|
||||
maxretry = 3
|
||||
bantime = 1h
|
||||
```
|
||||
|
||||
### 2. 内核安全加固
|
||||
```bash
|
||||
# 安装安全组件
|
||||
sudo apt install linux-hardened apparmor apparmor-utils -y
|
||||
|
||||
# 启用AppArmor
|
||||
sudo apparmor_status
|
||||
sudo aa-enforce /etc/apparmor.d/* # 强制所有配置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 五、性能优化设置
|
||||
### 1. 交换空间优化
|
||||
```bash
|
||||
# 调整Swappiness值(推荐10-30)
|
||||
echo 'vm.swappiness=10' | sudo tee -a /etc/sysctl.conf
|
||||
|
||||
# 启用Zswap压缩缓存(内存<8GB时尤其有效)
|
||||
echo 'zswap.enabled=1' | sudo tee -a /etc/sysctl.conf
|
||||
```
|
||||
|
||||
### 2. 文件描述符与进程优化
|
||||
```bash
|
||||
# 提高系统限制
|
||||
sudo nano /etc/security/limits.conf
|
||||
```
|
||||
```conf
|
||||
* soft nofile 65535
|
||||
* hard nofile 65535
|
||||
* soft nproc 65535
|
||||
* hard nproc 65535
|
||||
```
|
||||
|
||||
### 3. 日志管理(防止占满磁盘)
|
||||
```bash
|
||||
# 安装日志轮询工具
|
||||
sudo apt install logrotate -y
|
||||
|
||||
# 手动压缩现有大日志
|
||||
sudo find /var/log -size +100M -exec truncate -s 10M {} \;
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 六、审计与监控
|
||||
### 安装基础监控组件
|
||||
```bash
|
||||
sudo apt install sysstat htop net-tools tree ncdu
|
||||
|
||||
# 启用sysstat数据收集
|
||||
sudo sed -i 's/false/true/g' /etc/default/sysstat
|
||||
sudo systemctl enable --now sysstat
|
||||
```
|
||||
|
||||
### 关键审计命令
|
||||
```bash
|
||||
# 检查异常登录:
|
||||
sudo lastb -a | head -20
|
||||
|
||||
# 检查SUID文件:
|
||||
sudo find / -perm /4000 -ls
|
||||
|
||||
# 列出开放端口:
|
||||
sudo ss -tunlp
|
||||
```
|
||||
|
||||
> 📊 **推荐可视化工具**:
|
||||
> - Cockpit (轻量级Web面板):`sudo apt install cockpit`
|
||||
> - Netdata (实时监控):`bash <(curl -Ss https://my-netdata.io/kickstart.sh)`
|
||||
|
||||
---
|
||||
|
||||
**最终安全检查清单**:
|
||||
```bash
|
||||
echo "[+] SSH 配置"
|
||||
sudo sshd -t && grep -E "PermitRoot|PasswordAuth" /etc/ssh/sshd_config
|
||||
|
||||
echo "[+] 防火墙状态"
|
||||
sudo ufw status
|
||||
|
||||
echo "[]+ 更新状态"
|
||||
sudo unattended-upgrades --dry-run
|
||||
```
|
||||

|
||||
*(安全层示意图:网络防火墙→系统加固→应用防护)*
|
||||
|
||||
> 🔐 **维护建议**:
|
||||
> 1. 每月执行:`sudo lynis audit system` (安装:`apt install lynis`)
|
||||
> 2. 每季度更新所有SSL证书,即使未到期
|
||||
> 3. 使用自动配置管理工具(如Ansible)维护服务器状态
|
||||
|
||||
**文档版本**: v1.2
|
||||
**测试环境**: Debian 12.5 (Kernel 6.1.x) 云服务器
|
||||
**最后更新**: 2024-06-15
|
241
content/blog/1.技术栈/06.Debian 12 安装nodejs.md
Normal file
241
content/blog/1.技术栈/06.Debian 12 安装nodejs.md
Normal file
@@ -0,0 +1,241 @@
|
||||
---
|
||||
title: Debian 12 安装nodejs
|
||||
description: 在Debian 12 中安装nodejs
|
||||
date: 2025-05-25
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250618160517581.png
|
||||
navigation:
|
||||
icon: simple-icons:debian
|
||||
---
|
||||
### **方法 1:使用 Debian 官方仓库(简单但不一定最新)**
|
||||
```bash
|
||||
# 更新软件包列表
|
||||
sudo apt update
|
||||
|
||||
# 安装 Node.js 和 npm
|
||||
sudo apt install -y nodejs npm
|
||||
|
||||
# 验证安装
|
||||
node -v
|
||||
npm -v
|
||||
```
|
||||
|
||||
**特点**:
|
||||
- 安装最简单快捷
|
||||
- 版本可能较旧(Debian 12 默认提供 Node.js 18.x)
|
||||
- 适合不需要最新版本的用户
|
||||
|
||||
---
|
||||
|
||||
### **方法2:使用volta安装**
|
||||
```bash
|
||||
# On most Unix systems including macOS, you can install with a single command:
|
||||
curl https://get.volta.sh | bash
|
||||
|
||||
# Download and install Node.js:
|
||||
volta install node@22
|
||||
|
||||
# Verify the Node.js version:
|
||||
node -v # Should print "v22.16.0".
|
||||
|
||||
# Verify npm version:
|
||||
npm -v # Should print "10.9.2".
|
||||
|
||||
# Download and install pnpm:
|
||||
volta install pnpm
|
||||
|
||||
# Verify pnpm version:
|
||||
pnpm -v # Should print "10.12.1".
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### **方法 3:手动下载二进制包(灵活选择版本)**
|
||||
[官网](https://nodejs.org/)
|
||||
|
||||
```bash
|
||||
# 1. 下载指定版本(示例为 v20.x)
|
||||
wget https://nodejs.org/dist/v22.16.0/node-v22.16.0-linux-x64.tar.xz
|
||||
# 创建目录
|
||||
sudo mkdir -p /usr/local/lib/nodejs
|
||||
# 解压
|
||||
sudo tar -xJf node-v22.16.0-linux-x64.tar.xz -C /usr/local/lib/nodejs
|
||||
|
||||
# 创建对应的软链接
|
||||
# 创建 node 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/node /usr/bin/node
|
||||
# 创建 npm 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/npm /usr/bin/npm
|
||||
# 创建 npx 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/npx /usr/bin/npx
|
||||
|
||||
# 在~/.bashrc文件末尾中加入nodejs到PATH环境变量中
|
||||
export PATH=/usr/local/lib/node-v22.16.0-linux-x64/bin:$PATH
|
||||
# 重载 ~/.profile
|
||||
source ~/.bashrc
|
||||
|
||||
# 4. 验证安装
|
||||
node -v
|
||||
npm -v
|
||||
```
|
||||
|
||||
**特点**:
|
||||
- 可自由选择任何版本
|
||||
- 不依赖系统仓库
|
||||
- 需要手动更新版本
|
||||
|
||||
---
|
||||
|
||||
### **安装 pnpm、yarn、bun、cpnm**
|
||||
如果没有配置镜像加速,先配置加速:
|
||||
|
||||
```bash
|
||||
npm config set registry https://registry.npmmirror.com
|
||||
```
|
||||
|
||||
#### **安装 cnpm**
|
||||
```bash
|
||||
# 全局安装
|
||||
sudo npm install -g cnpm --registry=https://registry.npmmirror.com
|
||||
# 查看安装情况
|
||||
ls -la /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin
|
||||
# 创建 cnpm 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/cnpm /usr/bin/cnpm
|
||||
# 查看版本
|
||||
cnpm -v
|
||||
```
|
||||
|
||||
#### **安装 pnpm**
|
||||
```bash
|
||||
# 全局安装
|
||||
sudo npm install -g pnpm
|
||||
# 查看安装情况
|
||||
ls -la /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin
|
||||
# 创建 pnpm 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/npx /usr/bin/pnpm
|
||||
# 查看版本
|
||||
pnpm -v
|
||||
```
|
||||
|
||||
#### **安装 yarn**
|
||||
```bash
|
||||
# 全局安装
|
||||
sudo npm install -g yarn
|
||||
# 查看
|
||||
ls -la /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin
|
||||
# 创建 yarn 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/npx /usr/bin/yarn
|
||||
# 查看版本
|
||||
yarn -v
|
||||
```
|
||||
|
||||
#### **安装 bun**
|
||||
Linux用户-安装Bun需要解压缩包。使用 `sudo apt install unzip` 安装解压包。强烈建议使用5.6或更高版本的内核,但最低版本为5.1。使用 `uname -r` 检查内核版本。
|
||||
|
||||
```bash
|
||||
# 全局安装
|
||||
sudo cnpm install -g bun
|
||||
# 查看
|
||||
ls -la /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin
|
||||
# 创建 bun 软链
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v22.16.0-linux-x64/bin/bun /usr/bin/bun
|
||||
# 查看版本
|
||||
bun -v
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### **切换版本**
|
||||
如需切换版本,例如 `v18.20.7`,可以删除现有的软链接:
|
||||
|
||||
```bash
|
||||
sudo rm /usr/bin/node
|
||||
sudo rm /usr/bin/npm
|
||||
sudo rm /usr/bin/npx
|
||||
sudo rm /usr/bin/pnpm
|
||||
sudo rm /usr/bin/yarn
|
||||
sudo rm /usr/bin/bun
|
||||
sudo rm /usr/bin/cnpm
|
||||
```
|
||||
|
||||
创建新的软链接:
|
||||
|
||||
```bash
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v18.20.7-linux-x64/bin/node /usr/bin/node
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v18.20.7-linux-x64/bin/npm /usr/bin/npm
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v18.20.7-linux-x64/bin/npx /usr/bin/npx
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v18.20.7-linux-x64/bin/pnpm /usr/bin/pnpm
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v18.20.7-linux-x64/bin/bun /usr/bin/bun
|
||||
sudo ln -s /usr/local/lib/nodejs/node-v18.20.7-linux-x64/bin/cnpm /usr/bin/cnpm
|
||||
```
|
||||
|
||||
验证安装:
|
||||
|
||||
```bash
|
||||
node -v
|
||||
npm -v
|
||||
npx -v
|
||||
pnpm -v
|
||||
yarn -v
|
||||
```
|
||||
|
||||
查看当前配置:
|
||||
|
||||
```bash
|
||||
npm config list --json
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### **方法 3:fnm方式安装(不推荐)**
|
||||
#### **npm**
|
||||
```bash
|
||||
# Download and install fnm:
|
||||
curl -o- https://fnm.vercel.app/install | bash
|
||||
|
||||
# Download and install Node.js:
|
||||
fnm install 22
|
||||
|
||||
# Verify the Node.js version:
|
||||
node -v # Should print "v22.16.0".
|
||||
|
||||
# Verify npm version:
|
||||
npm -v # Should print "10.9.2".
|
||||
```
|
||||
|
||||
#### **yarn**
|
||||
```bash
|
||||
# Download and install Yarn:
|
||||
corepack enable yarn
|
||||
# Verify Yarn version:
|
||||
yarn -v
|
||||
```
|
||||
|
||||
#### **pnpm**
|
||||
```bash
|
||||
# Download and install pnpm:
|
||||
corepack enable pnpm
|
||||
# Verify pnpm version:
|
||||
pnpm -v
|
||||
```
|
||||
|
||||
#### **nodejs包镜像加速**
|
||||
```bash
|
||||
npm config set registry https://registry.npmmirror.com
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
### **对比 npm、Yarn、pnpm**
|
||||
| 特性 | npm | Yarn (v1/Yarn Classic) | Yarn Berry (v2+) | pnpm |
|
||||
|---------------------------|------------------------------|------------------------------|------------------------------|------------------------------|
|
||||
| **发布时间** | 2010 (Node.js 自带) | 2016 (Facebook 推出) | 2020 (Yarn 2.0 重大更新) | 2017 (独立发展) |
|
||||
| **安装速度** | ⏳ 慢(线性安装) | 🚀 较快(并行下载) | 🚀 快(改进缓存) | ⚡ 极快(硬链接 + 符号链接) |
|
||||
| **依赖管理** | node_modules 嵌套结构 | node_modules 扁平化 | Plug’n’Play (PnP) 无 node_modules | 硬链接 + 全局存储(节省空间) |
|
||||
| **缓存机制** | 有缓存,但效率一般 | 缓存优化较好 | 增量缓存 + 零安装(Zero-Installs) | 全局存储,依赖可复用 |
|
||||
| **锁文件** | package-lock.json | yarn.lock | yarn.lock + .pnp.cjs | pnpm-lock.yaml |
|
||||
| **安全性** | 🔒 一般(依赖可能被篡改) | 🔒 较好(校验严格) | 🔒 最好(离线模式 + 校验) | 🔒 最好(内容可寻址存储) |
|
||||
| **Monorepo 支持** | 有限(需配合 Lerna) | 支持 Workspaces | 原生 Workspaces + PnP | 原生 Workspaces + 高效链接 |
|
||||
| **磁盘占用** | 高(重复依赖多) | 中(扁平化减少重复) | 低(PnP 无 node_modules) | 极低(全局存储 + 硬链接) |
|
||||
| **命令行体验** | 基础功能 | 更友好(进度条、交互提示) | 现代化(插件系统) | 简洁高效 |
|
||||
| **兼容性** | 100% 兼容 Node.js | 兼容 npm 生态 | 需适配 PnP(部分库不兼容) | 兼容 npm/Yarn 生态 |
|
||||
| **推荐场景** | 简单项目 / Node.js 默认 | 旧项目迁移 / 稳定需求 | 大型 Monorepo / 严格依赖控制 | 高效开发 / 节省磁盘空间 |
|
35
content/blog/1.技术栈/07.MySQL 中如何忽略表名的大小写.md
Normal file
35
content/blog/1.技术栈/07.MySQL 中如何忽略表名的大小写.md
Normal file
@@ -0,0 +1,35 @@
|
||||
---
|
||||
title: MySQL 中如何忽略表名的大小写
|
||||
description: 如何在MySQL中忽略表名的大小写
|
||||
date: 2025-06-01
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250619124538532.png
|
||||
navigation:
|
||||
icon: simple-icons:mysql
|
||||
---
|
||||
在 MySQL 中,默认情况下表名是大小写敏感的。但是你可以通过设置来实现忽略表名的大小写。有两种方法可以做到这一点:
|
||||
|
||||
方法一:修改配置文件
|
||||
编辑 MySQL 的配置文件 my.cnf 或 my.ini(具体文件名取决于操作系统和 MySQL 版本),在 [mysqld] 部分添加以下行:
|
||||
|
||||
```
|
||||
lower_case_table_names = 1
|
||||
```
|
||||
|
||||
|
||||
然后保存并重新启动 MySQL 服务。
|
||||
|
||||
设置为 0:表名大小写敏感(默认)。
|
||||
设置为 1:将表名存储为小写,并在比较表名时不区分大小写。
|
||||
设置为 2:将表名存储为小写,并在比较表名时区分大小写(仅在非 Windows 环境下可用)。
|
||||
方法二:动态设置
|
||||
如果无法修改配置文件,你可以在 MySQL 启动后,使用以下命令动态设置:
|
||||
|
||||
```
|
||||
SET GLOBAL lower_case_table_names = 1;
|
||||
```
|
||||
|
||||
|
||||
请注意,这种方式在 MySQL 重启后会失效,除非再次设置。
|
||||
|
||||
在任何情况下,修改这个设置都需要谨慎考虑,因为它可能会影响现有的数据库和应用程序。在进行此类更改之前,请务必备份数据库,并确保了解潜在的影响和风险。
|
||||
|
30
content/blog/1.技术栈/08.Docker 里配置hosts.md
Normal file
30
content/blog/1.技术栈/08.Docker 里配置hosts.md
Normal file
@@ -0,0 +1,30 @@
|
||||
---
|
||||
title: Docker 里配置hosts
|
||||
description: 在Docker里配置hosts
|
||||
date: 2025-06-24
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250621163604646.png
|
||||
navigation:
|
||||
icon: simple-icons:docker
|
||||
---
|
||||
# 一:启动容器时加上“—add-host”参数
|
||||
|
||||
```
|
||||
docker run
|
||||
--add-host='lijue.me:127.0.0.1'
|
||||
--add-host='www.lijue.me:192.168.1.1'
|
||||
--name hello-docker
|
||||
-it reg.lijue.me/public/hello-docker:latest
|
||||
```
|
||||
|
||||
|
||||
# 二:通过docker-compose配置extra_hosts属性
|
||||
|
||||
```
|
||||
1. `version: '3'`
|
||||
2. `services:`
|
||||
3. `web:`
|
||||
4. `image: hello-docker:latest`
|
||||
5. `extra_hosts:`
|
||||
6. `- 'www.lijue.me:192.168.1.1'`
|
||||
7. `- 'lijue.me:127.0.0.1'`
|
||||
```
|
74
content/blog/1.技术栈/09.AppWrite 项目资源占用情况.md
Normal file
74
content/blog/1.技术栈/09.AppWrite 项目资源占用情况.md
Normal file
@@ -0,0 +1,74 @@
|
||||
---
|
||||
title: AppWrite 项目资源占用情况
|
||||
description: AppWrite 项目资源占用情况
|
||||
date: 2025-06-26
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250622140934487.png
|
||||
navigation:
|
||||
icon: simple-icons:appwrite
|
||||
---
|
||||
## CPU占用不高,内存经过统计:
|
||||
|
||||
> Debian12 Docker-compose部署AppWrite 1.7.3版
|
||||
> 内存占用1.72G
|
||||
|
||||
```
|
||||
根据 docker-compose 文件中的所有 Appwrite 相关容器,内存占用情况如下:
|
||||
|
||||
### 主要服务容器内存占用:
|
||||
|
||||
- appwrite (主服务): 345.5 MiB
|
||||
|
||||
- appwrite-realtime: 89.17 MiB
|
||||
|
||||
- appwrite-browser: 196.9 MiB
|
||||
|
||||
- appwrite-assistant: 98.13 MiB
|
||||
|
||||
- appwrite-mariadb: 125.7 MiB
|
||||
|
||||
- appwrite-redis-insight-1: 118.2 MiB
|
||||
|
||||
- appwrite-graphql-explorer: 53.55 MiB
|
||||
|
||||
### Worker 和 Task 容器内存占用:
|
||||
|
||||
- 各种 worker 容器: 30-46 MiB 每个
|
||||
|
||||
- 各种 task 容器: 33-46 MiB 每个
|
||||
|
||||
- 总计约 20+ 个 worker/task 容器
|
||||
|
||||
### 辅助服务容器内存占用:
|
||||
|
||||
- appwrite-redis: 10.66 MiB
|
||||
|
||||
- appwrite-console: 6.188 MiB
|
||||
|
||||
- appwrite-adminer: 8.625 MiB
|
||||
|
||||
- appwrite-mailcatcher: 21.36 MiB
|
||||
|
||||
- appwrite-requestcatcher: 20.09 MiB
|
||||
|
||||
- appwrite-traefik: 48.15 MiB
|
||||
|
||||
## 最终统计结果:
|
||||
|
||||
Appwrite 所有容器总内存占用:1,761.91 MiB ≈ 1.72 GiB
|
||||
|
||||
这个数字包含了:
|
||||
|
||||
- Appwrite 核心服务
|
||||
|
||||
- 所有 worker 和 task 进程
|
||||
|
||||
- 数据库 (MariaDB)
|
||||
|
||||
- 缓存 (Redis)
|
||||
|
||||
- 反向代理 (Traefik)
|
||||
|
||||
- 各种辅助工具和可视化界面
|
||||
|
||||
所以 Appwrite 项目精确占用约 1.72 GB 内存。
|
||||
```
|
49
content/blog/1.技术栈/10.从Supabase迁移到Appwrite.md
Normal file
49
content/blog/1.技术栈/10.从Supabase迁移到Appwrite.md
Normal file
@@ -0,0 +1,49 @@
|
||||
---
|
||||
title: 从Supabase迁移到Appwrite
|
||||
description: AI 扩写
|
||||
date: 2025-07-01
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250623164451378.png
|
||||
navigation:
|
||||
icon: simple-icons:supabase
|
||||
---
|
||||
## 最初的技术选型
|
||||
|
||||
去年春节前开发AI平台时,我在后端服务的选择上——Github社区有两个优秀的开源项目:Supabase和Appwrite。
|
||||
|
||||
**当时的决策因素**:
|
||||
1. **社区热度**:Supabase的Star数量明显更多
|
||||
2. **UI设计**:后台管理界面的配色和布局更符合我的审美
|
||||
3. **命名偏好**:单纯喜欢"Supabase"这个名字的科技感
|
||||
4. **商业化支持**:国内有memfire cloud这样的二开商业项目
|
||||
5. **退出策略**:不想自托管时可以有现成的过渡方案
|
||||
|
||||
## 使用后的痛点
|
||||
|
||||
随着项目的深入开发,我逐渐感受到了一些问题:
|
||||
|
||||
- **系统太重**:Supabase的"全家桶"式设计带来了不必要的复杂度
|
||||
- **功能过剩**:很多内置功能在项目中根本没有用到
|
||||
- **维护成本**:自托管的运维负担超出预期
|
||||
|
||||
## Appwrite
|
||||
|
||||
上个月Appwrite发布的**Sites功能**让我眼前一亮——这个对标Vercel的新功能完全改变了我对它的认知。经过重新评估:
|
||||
|
||||
✅ 更轻量的架构
|
||||
✅ 恰到好处的功能集
|
||||
✅ 持续创新的能力
|
||||
|
||||
## 迁移计划
|
||||
|
||||
现在已经着手准备后端迁移:
|
||||
1. 收集双方的SDK文档
|
||||
2. 制定cursor-rules转换规则
|
||||
3. 利用AI辅助代码转换
|
||||
|
||||
**嘿,这告诉我们**:
|
||||
技术选型时除了看表面参数,更应该深入评估:
|
||||
- 项目的实际需求
|
||||
- 长期维护成本
|
||||
- 技术栈的发展潜力
|
||||
|
||||
这次迁移虽然会带来短期工作量,但从长期来看绝对是值得的!
|
109
content/blog/1.技术栈/11.Linux 系统 Swap 分区配置指南.md
Normal file
109
content/blog/1.技术栈/11.Linux 系统 Swap 分区配置指南.md
Normal file
@@ -0,0 +1,109 @@
|
||||
---
|
||||
title: Linux 系统 Swap 分区配置指南
|
||||
description: 在云服务器上配置Swap分区
|
||||
date: 2025-07-10
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250623214305360.png
|
||||
navigation:
|
||||
icon: simple-icons:linux
|
||||
---
|
||||
## **1. Swap 分区简介**
|
||||
Swap(交换分区)是 Linux 系统用来扩展内存的一种机制。当物理内存(RAM)耗尽时,操作系统会将部分不活跃的内存页(inactive memory)移至 Swap 分区,避免 **OOM(Out Of Memory)** 错误导致的服务崩溃。
|
||||
|
||||
### **Swap 分区的适用场景**
|
||||
✅ **内存不足时**:Swap 可使系统暂存部分数据,防止进程被强制终止
|
||||
✅ **突发高负载时**:避免系统因短时内存不足而崩溃
|
||||
❌ **SSD/高性能盘场景**:频繁 Swap 会导致 I/O 瓶颈,影响性能
|
||||
❌ **数据库/高性能应用**:Swap 会降低内存访问速度,建议直接增加物理内存
|
||||
|
||||
---
|
||||
|
||||
## **2. 查看当前 Swap 配置**
|
||||
**检查当前是否已启用 Swap:**
|
||||
```bash
|
||||
swapon --show
|
||||
```
|
||||
- **无输出**:表示未配置 Swap 分区
|
||||
- **有输出**:显示已启用的 Swap 设备及其大小
|
||||
|
||||
---
|
||||
|
||||
## **3. 配置 Swap 分区**
|
||||
### **(1)创建 Swap 文件(推荐)**
|
||||
Swap 可以基于 **分区** 或 **文件**,推荐使用文件方式(更灵活)。
|
||||
```bash
|
||||
# 创建一个 1GB 的 Swap 文件(可按需调整大小)
|
||||
sudo dd if=/dev/zero of=/swapfile bs=1M count=1024
|
||||
|
||||
# 确保该文件只能由 root 访问
|
||||
sudo chmod 600 /swapfile
|
||||
|
||||
# 将文件转换为 Swap 格式
|
||||
sudo mkswap /swapfile
|
||||
```
|
||||
|
||||
> ⚠️ **注意**:
|
||||
> - 如果 `mkswap` 报错 **`swap area needs to be at least 40 KiB`**,说明文件过小,需调整 `bs=1M count=1024`(1GB)。
|
||||
> - 生产环境建议 Swap 大小 = **1~2 倍物理内存**(如 4GB 内存可配 4~8GB Swap)。
|
||||
|
||||
### **(2)启用 Swap 分区**
|
||||
```bash
|
||||
sudo swapon /swapfile
|
||||
```
|
||||
|
||||
验证是否生效:
|
||||
```bash
|
||||
free -h # 查看 Swap 使用情况
|
||||
```
|
||||
|
||||
### **(3)设置开机自动挂载**
|
||||
在 `/etc/fstab` 中追加配置:
|
||||
```bash
|
||||
echo '/swapfile none swap sw 0 0' | sudo tee -a /etc/fstab
|
||||
```
|
||||
验证配置:
|
||||
```bash
|
||||
cat /etc/fstab | grep swap
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## **4. 调整内存管理策略(可选)**
|
||||
默认情况下,Linux 倾向于使用物理内存而非 Swap。
|
||||
若希望 **减少 Swap 使用**(避免频繁 I/O),可调整 `vm.swappiness`(推荐值:10~60):
|
||||
```bash
|
||||
# 查看当前值(默认60)
|
||||
cat /proc/sys/vm/swappiness
|
||||
|
||||
# 临时调整
|
||||
sudo sysctl vm.swappiness=10
|
||||
|
||||
# 永久生效
|
||||
echo "vm.swappiness=10" >> /etc/sysctl.conf
|
||||
```
|
||||
> **参数说明**:
|
||||
> - `0`:尽量不使用 Swap(可能导致 OOM)
|
||||
> - `10`:低内存时少量使用
|
||||
> - `60`:默认值
|
||||
|
||||
---
|
||||
|
||||
## **5. 关闭 Swap(如需)**
|
||||
```bash
|
||||
swapoff /swapfile # 停止 Swap
|
||||
rm -f /swapfile # 删除 Swap 文件
|
||||
sed -i '/swapfile/d' /etc/fstab # 移除 fstab 中的配置
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## **6. 云服务器(ECS)注意事项**
|
||||
- **普通云盘**:不建议用 Swap,因其 I/O 性能较差,易引发性能问题
|
||||
- **SSD/高效云盘**:可适当启用 Swap,但要避免频繁交换
|
||||
- **最优方案**:**升级实例规格**,直接增加物理内存
|
||||
|
||||
---
|
||||
|
||||
🎯 **总结**
|
||||
- **Swap 是临时方案**,长期内存不足仍需扩容物理内存
|
||||
- **监控 Swap 使用**,避免频繁触发磁盘 I/O
|
||||
- **高性能应用建议禁用 Swap**(如 Redis、MySQL)
|
213
content/blog/1.技术栈/12.Nuxt3 代码规范.md
Normal file
213
content/blog/1.技术栈/12.Nuxt3 代码规范.md
Normal file
@@ -0,0 +1,213 @@
|
||||
---
|
||||
title: Nuxt3 代码规范
|
||||
description: 这是一份提供给AI大模型的Nuxt3框架规范、编程标准,可以有效提高Cursor等大模型对Nuxt.js框架的编写能力。
|
||||
date: 2025-07-12
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250624125918171.png
|
||||
navigation:
|
||||
icon: simple-icons:nuxtdotjs
|
||||
---
|
||||
## 概述
|
||||
这是一份提供给AI大模型的Nuxt3框架规范、编程标准,可以有效提高Cursor等大模型对Nuxt.js框架的编写能力。
|
||||
|
||||
---
|
||||
description: 本规则为 Nuxt.js 项目提供全面的最佳实践和编码标准,涵盖代码组织、性能、安全性、测试和常见陷阱。旨在确保 Nuxt.js 应用程序的可维护性、可扩展性和安全性。
|
||||
globs: *.vue,*.js,*.ts,*.mjs,*.mts,*.jsx,*.tsx,*.config.js,*.config.ts
|
||||
---
|
||||
|
||||
- **启用 ESLint 支持:** 使用 `@nuxt/eslint` 模块来配置项目感知的 ESLint。这确保代码质量和一致性。
|
||||
- 运行 `npx nuxi module add eslint` 添加模块。
|
||||
- 根据需要自定义生成的 `eslint.config.mjs` 文件。
|
||||
- **采用 Nuxt.js 模块:** 利用 Nuxt.js 模块来封装功能并维护干净的代码库。在实现自定义解决方案之前先探索现有模块(例如,用于服务端身份验证的 `@nuxt/auth`)。
|
||||
- **约定优于配置:** 遵循 Nuxt.js 约定来简化开发和协作。除非绝对必要,否则避免偏离约定。
|
||||
- **高效利用 Nuxt 布局:** 为多个页面共享的组件创建可重用布局,以确保一致性并节省开发时间。布局位于 `layouts/` 目录中。
|
||||
- **使用 Pinja 管理状态:** 使用 Pinia 进行状态管理。根据功能或特性组织 store 模块,以提高可维护性。
|
||||
- **将页面分解为组件:** 将页面分解为小的、可重用的组件,以增强可维护性、可测试性和可重用性。每个组件都应该有单一责任。
|
||||
- **明智地利用 Nuxt 插件:** 使用 Nuxt 插件在 Vue.js 初始化之前运行代码或添加全局功能。注意插件对性能的影响。插件位于 `plugins/` 目录中。
|
||||
- **针对 SEO 和性能进行优化:** 利用 Nuxt.js 的服务端渲染 (SSR) 来优化 SEO。为图片实现懒加载并优化资源以最小化初始加载时间。使用 Lighthouse 等工具识别性能瓶颈。
|
||||
- **实现错误处理和验证:** 实现强大的错误处理和验证机制,以提供无缝的用户体验。使用 Nuxt.js 中间件拦截请求和响应进行错误处理和数据验证。
|
||||
- **为代码编写文档:** 使用 JSDoc 等工具为组件、模块和自定义函数提供清晰简洁的文档。
|
||||
- **拥抱测试:** 使用 Jest、Vue Test Utils 和 Vitest 等工具编写单元测试、集成测试和端到端测试。
|
||||
|
||||
## 1. 代码组织和结构:
|
||||
|
||||
- **目录结构:**
|
||||
- `components/`:可重用的 Vue 组件。
|
||||
- `composables/`:可重用的组合式函数。
|
||||
- `layouts/`:应用程序布局。
|
||||
- `middleware/`:路由中间件。
|
||||
- `pages/`:应用程序页面(路由定义)。
|
||||
- `plugins/`:Nuxt.js 插件。
|
||||
- `server/`:API 路由和服务端逻辑。
|
||||
- `static/`:静态资源(例如,图片、字体)。
|
||||
- `store/`:Pinia stores(可选,但推荐)。
|
||||
- `utils/`:工具函数。
|
||||
- **文件命名约定:**
|
||||
- 组件:`PascalCase.vue`(例如,`MyComponent.vue`)
|
||||
- 组合式函数:`usePascalCase.js` 或 `usePascalCase.ts`(例如,`useCounter.js`)
|
||||
- 布局:`kebab-case.vue`(例如,`default.vue` 或 `custom-layout.vue`)
|
||||
- 页面:`kebab-case.vue`(例如,`index.vue`、`about.vue`、`product-details.vue`)
|
||||
- 插件:`kebab-case.js` 或 `kebab-case.ts`(例如,`analytics.js`)
|
||||
- Stores:`kebab-case.js` 或 `kebab-case.ts`(例如,`user-store.js`)
|
||||
- 工具函数:`camelCase.js` 或 `camelCase.ts`(例如,`formatDate.js`)
|
||||
- **模块组织:**
|
||||
- 将相关功能分组到单独的模块中。
|
||||
- 在 `nuxt.config.js` 或 `nuxt.config.ts` 中使用 `@nuxt/modules` 数组注册模块。
|
||||
- 创建自定义模块来封装复杂逻辑。
|
||||
- **组件架构:**
|
||||
- 优先使用组合而非继承。
|
||||
- 对简单的 UI 元素使用函数式组件。
|
||||
- 设计组件时考虑可重用性和可测试性。
|
||||
- 考虑使用插槽进行灵活的组件组合。
|
||||
- **代码分割:**
|
||||
- 利用动态导入进行基于路由的代码分割。
|
||||
- 使用 `import()` 将大组件分割成更小的块。
|
||||
- 使用 Webpack Bundle Analyzer 等工具分析包大小。
|
||||
|
||||
## 2. 常见模式和反模式:
|
||||
|
||||
- **设计模式:**
|
||||
- **组合式 API:** 使用组合式 API 来组织组件逻辑。
|
||||
- **Store 模式 (Pinia):** 使用 Pinia 实现集中式状态管理系统。
|
||||
- **中间件模式:** 使用中间件进行身份验证、授权和数据验证。
|
||||
- **插件模式:** 为全局功能和第三方库集成创建插件。
|
||||
- **推荐方法:**
|
||||
- **API 通信:** 在组件内使用 `useFetch` 或 `useAsyncData` 组合式函数进行 API 调用。
|
||||
- **表单处理:** 利用 Vue 的内置表单处理功能与 `v-model` 和像 VeeValidate 这样的验证库。
|
||||
- **身份验证:** 使用 `@nuxt/auth` 库或自定义解决方案实现安全的身份验证流程。
|
||||
- **授权:** 使用中间件和 Pinia stores 实现基于角色的访问控制 (RBAC)。
|
||||
- **反模式:**
|
||||
- **直接修改 props:** 避免从子组件直接修改父组件数据。请使用 `emit` 代替。
|
||||
- **过度使用全局状态:** 将全局状态的使用限制在必要的应用程序数据上。对本地数据考虑使用组件级状态。
|
||||
- **忽略错误处理:** 始终处理 API 调用和其他异步操作中的潜在错误。
|
||||
- **编写过于复杂的组件:** 将大组件分解为更小、更易管理的部分。
|
||||
- **状态管理最佳实践:**
|
||||
- **单一数据源:** 在 Pinia stores 中为应用程序状态维护单一、一致的数据源。
|
||||
- **不可变性:** 将状态视为不可变的。使用函数来更新 store 而不是直接操作数据。
|
||||
- **清晰的命名约定:** 为 store 模块、actions 和 mutations 使用描述性名称。
|
||||
- **模块化:** 根据功能或特性将 stores 分成模块。
|
||||
- **错误处理模式:**
|
||||
- **集中式错误处理:** 实现全局错误处理器来捕获未处理的异常。
|
||||
- **错误边界:** 使用错误边界来隔离组件故障并防止级联错误。
|
||||
- **用户友好的错误消息:** 为用户提供清晰和有用的错误消息。
|
||||
|
||||
## 3. 性能考虑:
|
||||
|
||||
- **优化技术:**
|
||||
- **懒加载:** 为图片、组件和路由实现懒加载。
|
||||
- **代码分割:** 将应用程序分割成更小的块以获得更快的初始加载时间。
|
||||
- **Tree Shaking:** 在构建过程中删除未使用的代码。
|
||||
- **缓存:** 缓存 API 响应和静态资源以减少服务器负载。
|
||||
- **图片优化:** 使用 `nuxt/image` 等工具优化图片。使用适当的图片格式(WebP)。将图片大小调整为适当大小。考虑使用 CDN 进行图片交付。
|
||||
- **内存管理:**
|
||||
- **避免内存泄漏:** 在组件卸载时清理事件监听器和定时器。
|
||||
- **使用弱引用:** 在可能的情况下对 DOM 元素使用弱引用。
|
||||
- **最小化对象创建:** 避免创建不必要的对象和数组。
|
||||
- **渲染优化:**
|
||||
- **虚拟化:** 对大列表使用虚拟化以提高渲染性能。
|
||||
- **记忆化:** 记忆化昂贵的计算以避免冗余计算。有效使用 `computed` 属性以避免不必要的重新渲染。
|
||||
- **防抖和节流:** 对事件处理器使用防抖和节流以减少函数调用次数。
|
||||
- **包大小优化:**
|
||||
- **分析包大小:** 使用 Webpack Bundle Analyzer 识别大依赖项。
|
||||
- **删除未使用的依赖项:** 删除未使用的依赖项以减少包大小。
|
||||
- **使用更小的替代方案:** 考虑使用更小的替代方案来替代大型库。
|
||||
- **优化依赖项:** 检查依赖项并确保您使用的是最高效的版本。
|
||||
- **懒加载策略:**
|
||||
- **基于路由的懒加载:** 仅在访问相应路由时加载组件。
|
||||
- **基于组件的懒加载:** 仅在组件在视口中可见时加载组件。
|
||||
|
||||
## 4. 安全最佳实践:
|
||||
|
||||
- **常见漏洞:**
|
||||
- **跨站脚本攻击 (XSS):** 通过正确清理用户输入和使用 Vue 的内置 HTML 转义来防止 XSS 攻击。
|
||||
- **跨站请求伪造 (CSRF):** 通过实现 CSRF 令牌来防止 CSRF 攻击。
|
||||
- **SQL 注入:** 避免原始 SQL 查询。使用 ORM(对象关系映射器)来防止 SQL 注入。
|
||||
- **身份验证和授权缺陷:** 实现安全的身份验证和授权机制。
|
||||
- **不安全的直接对象引用 (IDOR):** 实现适当的访问控制以防止对资源的未授权访问。
|
||||
- **输入验证:**
|
||||
- **服务端验证:** 始终在服务端验证用户输入。
|
||||
- **客户端验证:** 提供客户端验证以获得更好的用户体验(但不要依赖它作为验证的唯一来源)。
|
||||
- **清理输入:** 清理用户输入以删除潜在的有害字符。
|
||||
- **身份验证和授权模式:**
|
||||
- **JWT(JSON Web Tokens):** 使用 JWT 进行身份验证和授权。
|
||||
- **OAuth 2.0:** 为第三方身份验证实现 OAuth 2.0。
|
||||
- **基于角色的访问控制 (RBAC):** 实现 RBAC 来根据用户角色控制对资源的访问。
|
||||
- **数据保护策略:**
|
||||
- **加密:** 对静态和传输中的敏感数据进行加密。
|
||||
- **散列:** 使用强散列算法对密码和其他敏感数据进行散列。
|
||||
- **数据屏蔽:** 在日志和其他非生产环境中屏蔽敏感数据。
|
||||
- **安全的 API 通信:**
|
||||
- **HTTPS:** 始终使用 HTTPS 进行 API 通信。
|
||||
- **API 速率限制:** 实现 API 速率限制以防止滥用。
|
||||
- **身份验证和授权:** 对所有 API 端点要求身份验证和授权。
|
||||
|
||||
## 5. 测试方法:
|
||||
|
||||
- **单元测试:**
|
||||
- **测试单个组件:** 孤立地测试单个组件。
|
||||
- **模拟依赖项:** 模拟外部依赖项以在测试期间隔离组件。
|
||||
- **验证组件行为:** 验证组件正确渲染并按预期行为。
|
||||
- **集成测试:**
|
||||
- **测试组件交互:** 测试组件之间的交互。
|
||||
- **测试数据流:** 测试组件和 stores 之间的数据流。
|
||||
- **测试 API 集成:** 测试与外部 API 的集成。
|
||||
- **端到端测试:**
|
||||
- **模拟用户交互:** 模拟用户交互以测试应用程序的功能。
|
||||
- **测试整个应用程序流程:** 从头到尾测试整个应用程序流程。
|
||||
- **使用浏览器自动化工具:** 使用 Cypress 或 Playwright 等浏览器自动化工具。
|
||||
- **测试组织:**
|
||||
- **按功能组织测试:** 按功能或特性组织测试。
|
||||
- **使用描述性测试名称:** 使用描述性测试名称来清楚地说明每个测试正在测试什么。
|
||||
- **保持测试隔离:** 保持测试彼此隔离以避免干扰。
|
||||
- **模拟和存根:**
|
||||
- **使用模拟对象:** 使用模拟对象在测试期间替换外部依赖项。
|
||||
- **使用存根:** 使用存根用简化版本替换复杂函数。
|
||||
- **避免过度模拟:** 避免模拟太多代码,因为这会使测试效果降低。
|
||||
|
||||
## 6. 常见陷阱和注意事项:
|
||||
|
||||
- **常见错误:**
|
||||
- **错误的 `this` 上下文:** 注意 Vue 组件中的 `this` 上下文,使用箭头函数或 `bind` 来维护正确的上下文。
|
||||
- **异步数据处理:** 使用 `async/await` 或 Promises 正确处理异步数据加载。
|
||||
- **忘记取消订阅:** 在组件卸载时取消订阅事件监听器和定时器以防止内存泄漏。
|
||||
- **过度使用 `forceUpdate`:** 除非绝对必要,否则避免使用 `forceUpdate`,因为它会对性能产生负面影响。
|
||||
- **边缘情况:**
|
||||
- **服务端渲染 (SSR):** 了解客户端和服务端渲染之间的差异。
|
||||
- **浏览器兼容性:** 在不同浏览器中测试应用程序以确保兼容性。
|
||||
- **可访问性:** 在设计和开发应用程序时考虑可访问性。
|
||||
- **版本特定问题:**
|
||||
- **Nuxt 2 vs Nuxt 3:** 了解 Nuxt 2 和 Nuxt 3 之间的差异。
|
||||
- **Vue 2 vs Vue 3:** 了解 Vue 2 和 Vue 3 之间的差异。
|
||||
- **依赖项更新:** 仔细检查依赖项更新是否存在潜在的破坏性更改。
|
||||
- **兼容性问题:**
|
||||
- **浏览器支持:** 确保与目标浏览器兼容。
|
||||
- **设备兼容性:** 在不同设备上测试应用程序。
|
||||
- **操作系统兼容性:** 确保与目标操作系统兼容。
|
||||
- **调试策略:**
|
||||
- **使用浏览器开发者工具:** 使用浏览器开发者工具检查应用程序的状态和网络活动。
|
||||
- **使用 Vue Devtools:** 使用 Vue Devtools 检查 Vue 组件和数据。
|
||||
- **使用日志记录:** 使用日志记录来跟踪应用程序的行为。
|
||||
|
||||
## 7. 工具和环境:
|
||||
|
||||
- **推荐的开发工具:**
|
||||
- **VS Code:** Visual Studio Code 是一个流行的代码编辑器,具有出色的 Vue.js 支持。
|
||||
- **Vue Devtools:** Vue Devtools 是一个浏览器扩展,为 Vue.js 应用程序提供调试工具。
|
||||
- **ESLint:** ESLint 是一个强制执行编码标准的代码检查器。
|
||||
- **Prettier:** Prettier 是一个自动格式化代码的代码格式化器。
|
||||
- **构建配置:**
|
||||
- **`nuxt.config.js` 或 `nuxt.config.ts`:** 在 `nuxt.config.js` 或 `nuxt.config.ts` 中配置应用程序的构建设置。
|
||||
- **Webpack:** Nuxt 使用 Webpack 来打包应用程序。
|
||||
- **Vite:** Nuxt 3 默认使用 Vite 来打包应用程序,提供更快的构建和开发时间。
|
||||
- **代码检查和格式化:**
|
||||
- **ESLint:** 使用 ESLint 强制执行编码标准。
|
||||
- **Prettier:** 使用 Prettier 自动格式化代码。
|
||||
- **Husky:** 使用 Husky 在提交前运行代码检查器和格式化器。
|
||||
- **部署最佳实践:**
|
||||
- **服务端渲染 (SSR):** 将应用程序部署到支持 SSR 的服务器。
|
||||
- **静态站点生成 (SSG):** 为内容丰富的应用程序生成静态站点。
|
||||
- **CDN:** 使用 CDN 交付静态资源。
|
||||
- **CI/CD 集成:**
|
||||
- **持续集成 (CI):** 使用 Jenkins、GitLab CI 或 GitHub Actions 等 CI 工具自动化构建和测试过程。
|
||||
- **持续部署 (CD):** 使用 CD 工具自动化部署过程。
|
||||
|
||||
通过遵循这些最佳实践,您可以构建强健、可维护且可扩展的 Nuxt.js 应用程序。
|
190
content/blog/1.技术栈/13.Python 代码规范.md
Normal file
190
content/blog/1.技术栈/13.Python 代码规范.md
Normal file
@@ -0,0 +1,190 @@
|
||||
---
|
||||
title: Python 代码规范
|
||||
description: 这是一份提供给AI大模型的Python代码规范与编程标准,可以有效提高Cursor等大模型对Python项目的编写能力。
|
||||
date: 2025-07-12
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250624130616733.png
|
||||
navigation:
|
||||
icon: simple-icons:python
|
||||
---
|
||||
# 概述
|
||||
这是一份提供给AI大模型的Python代码规范与编程标准,可以有效提高Cursor等大模型对Python项目的编写能力。
|
||||
|
||||
---
|
||||
description: Python开发综合指南,涵盖代码组织、性能、安全性、测试等内容。这些规则旨在促进可维护、高效且安全的Python代码库。
|
||||
globs: *.py
|
||||
---
|
||||
# Python最佳实践与编码规范
|
||||
|
||||
本文档概述了Python开发的综合最佳实践和编码标准,旨在促进编写干净、高效、可维护和安全的代码。
|
||||
|
||||
## 1. 代码组织与结构
|
||||
|
||||
### 1.1 目录结构最佳实践
|
||||
|
||||
* **扁平结构优于嵌套(但不绝对)。** 从简单结构开始,按需重构
|
||||
* **包与模块:** 使用包(包含`__init__.py`的目录)对模块进行逻辑分组
|
||||
* **src布局:** 考虑使用`src`目录分离应用代码和项目级文件(setup.py、requirements.txt等),避免导入冲突并明确项目边界
|
||||
* **典型项目结构:**
|
||||
|
||||
project_name/
|
||||
├── src/
|
||||
│ ├── package_name/
|
||||
│ │ ├── __init__.py
|
||||
│ │ ├── module1.py
|
||||
│ │ ├── module2.py
|
||||
│ ├── main.py # 入口文件
|
||||
├── tests/
|
||||
│ ├── __init__.py
|
||||
│ ├── test_module1.py
|
||||
│ ├── test_module2.py
|
||||
├── docs/
|
||||
│ ├── conf.py
|
||||
│ ├── index.rst
|
||||
├── .gitignore
|
||||
├── pyproject.toml 或 setup.py
|
||||
├── README.md
|
||||
├── requirements.txt 或 requirements-dev.txt
|
||||
|
||||
### 1.2 文件命名规范
|
||||
|
||||
* **模块:** 小写字母,使用下划线增强可读性(如`my_module.py`)
|
||||
* **包:** 全小写(如`my_package`),非必要不使用下划线
|
||||
* **测试文件:** 以`test_`开头(如`test_my_module.py`)
|
||||
|
||||
### 1.3 模块组织最佳实践
|
||||
|
||||
* **单一职责原则:** 每个模块应有明确定义的用途
|
||||
* **导入规范:**
|
||||
* 顺序:标准库→第三方库→本地模块
|
||||
* 优先使用绝对导入(如`from my_package.module1 import function1`)
|
||||
* 在复杂包结构中需明确相对导入时使用显式相对导入(`from . import sibling_module`)
|
||||
* **常量:** 使用全大写定义模块级常量(如`MAX_ITERATIONS = 100`)
|
||||
* **双下划线名称:** `__all__`、`__version__`等应放在模块文档字符串之后、所有导入之前(`from __future__`除外)。使用`__all__`显式声明公共API
|
||||
|
||||
### 1.4 组件架构建议
|
||||
|
||||
* **分层架构:** 适用于大型应用,将关注点分离为表现层、业务逻辑层和数据访问层
|
||||
* **微服务:** 超大型系统可拆分为小型独立服务
|
||||
* **六边形/整洁架构:** 强调业务逻辑与数据库/框架等外部依赖的解耦
|
||||
* **依赖注入:** 提高可测试性并降低耦合度
|
||||
|
||||
### 1.5 代码分割策略
|
||||
|
||||
* **按功能拆分:** 基于不同功能划分模块(如用户管理、数据处理)
|
||||
* **按层级拆分:** 分离表现层、业务逻辑层和数据访问代码
|
||||
* **懒加载:** 使用`importlib.import_module()`实现按需加载,优化启动时间
|
||||
* **条件导入:** 根据特定条件导入模块
|
||||
|
||||
## 2. 常见模式与反模式
|
||||
|
||||
### 2.1 设计模式
|
||||
|
||||
* **单例模式:** 限制类只能实例化一个对象
|
||||
* **工厂模式:** 创建对象时无需指定具体类
|
||||
* **观察者模式:** 建立对象间一对多依赖关系
|
||||
* **策略模式:** 定义算法族并使其可互换
|
||||
* **装饰器模式:** 动态扩展对象功能
|
||||
* **上下文管理器:** 确保资源正确清理(如自动关闭文件)
|
||||
|
||||
### 2.2 常见任务的推荐方案
|
||||
|
||||
* **数据验证:** 使用`pydantic`或`marshmallow`等库
|
||||
* **配置管理:** 使用`python-decouple`、`dynaconf`或标准库的`configparser`
|
||||
* **日志记录:** 使用`logging`模块实现结构化日志
|
||||
* **命令行接口:** 使用`argparse`、`click`或`typer`
|
||||
* **异步编程:** 使用`asyncio`处理I/O密集型任务
|
||||
|
||||
### 2.3 反模式与代码异味
|
||||
|
||||
* **上帝类:** 承担过多职责的类,应拆分为专注单一功能的小类
|
||||
* **霰弹式变更:** 需在多处做小修改,表明内聚性不足
|
||||
* **面条代码:** 结构混乱难以追踪,应重构为定义明确的函数/类
|
||||
* **重复代码:** 提取公共代码为可复用函数/类(遵循DRY原则)
|
||||
* **魔法数值/字符串:** 使用命名常量替代硬编码值
|
||||
* **过早优化:** 避免在没有性能瓶颈分析前提下的优化
|
||||
|
||||
### 2.4 状态管理最佳实践
|
||||
|
||||
* **无状态函数:** 尽可能使用无状态函数
|
||||
* **不可变数据:** 使用不可变数据结构防止意外修改
|
||||
* **显式状态:** 使用类或数据结构明确管理状态,避免全局变量
|
||||
* **上下文变量:** Python 3.7+可使用`contextvars`管理异步应用中的请求级状态
|
||||
|
||||
### 2.5 错误处理模式
|
||||
|
||||
* **捕获特定异常:** 避免笼统捕获`Exception`或`BaseException`
|
||||
* **资源清理:** 使用`finally`确保清理代码必执行
|
||||
* **异常日志:** 记录完整堆栈信息
|
||||
* **异常消息:** 抛出包含明确错误信息的异常
|
||||
* **避免异常控制流:** 异常应用于处理意外情况而非常规流程
|
||||
|
||||
## 3. 性能优化
|
||||
|
||||
### 3.1 优化技术
|
||||
|
||||
* **性能分析:** 使用`cProfile`定位瓶颈
|
||||
* **高效数据结构:** 根据场景选择(如`set`用于成员测试、`dict`用于查找)
|
||||
* **列表推导式与生成器:** 编写简洁高效的代码
|
||||
* **NumPy向量化:** 对数值计算使用向量化操作
|
||||
* **即时编译:** 性能关键代码考虑使用Numba等JIT编译器
|
||||
* **字符串拼接:** 使用`''.join(iterable)`高效拼接字符串
|
||||
|
||||
### 3.2 内存管理
|
||||
|
||||
* **内存分析:** 使用`memory_profiler`定位内存泄漏
|
||||
* **`__slots__`:** 减少类实例的内存占用
|
||||
* **生成器:** 处理大数据集时避免全部加载到内存
|
||||
|
||||
## 4. 安全性最佳实践
|
||||
|
||||
### 4.1 常见漏洞防范
|
||||
|
||||
* **SQL注入:** 使用参数化查询或ORM
|
||||
* **XSS攻击:** 对用户输入消毒并转义输出
|
||||
* **CSRF防护:** 使用CSRF令牌
|
||||
* **依赖漏洞:** 定期审计和更新依赖项
|
||||
* **硬编码密钥:** 禁止在代码中硬编码密码/API密钥,使用环境变量管理
|
||||
|
||||
### 4.2 API安全通信
|
||||
|
||||
* **强制HTTPS:** 所有API通信必须加密
|
||||
* **速率限制:** 防止接口滥用
|
||||
* **输入验证:** 处理前验证所有API请求
|
||||
|
||||
## 5. 测试策略
|
||||
|
||||
### 5.1 单元测试要点
|
||||
|
||||
* **测试粒度:** 隔离测试单个函数/类/模块
|
||||
* **边界条件:** 特别测试边界情况和异常场景
|
||||
* **测试覆盖率:** 追求高覆盖率但避免教条化
|
||||
|
||||
### 5.2 集成测试建议
|
||||
|
||||
* **聚焦关键流程:** 关注核心用户场景
|
||||
* **模拟外部服务:** 使用mock替代真实外部依赖
|
||||
|
||||
## 6. 常见陷阱
|
||||
|
||||
### 6.1 高频错误
|
||||
|
||||
* **可变默认参数:** 函数定义中避免使用可变对象作为默认值
|
||||
* **变量作用域:** 注意嵌套函数中的变量作用域
|
||||
* **忽略异常:** 禁止直接忽略未处理的异常
|
||||
* **虚拟环境:** 必须使用虚拟环境管理项目依赖
|
||||
|
||||
## 7. 工具与环境
|
||||
|
||||
### 7.1 推荐工具链
|
||||
|
||||
* **IDE:** PyCharm、VS Code(搭配Python插件)
|
||||
* **包管理:** `pip`、`poetry`
|
||||
* **格式化:** `black`、`autopep8`
|
||||
* **静态检查:** `mypy`、`pylint`
|
||||
|
||||
### 7.2 CI/CD集成
|
||||
|
||||
* **自动化测试:** 每次提交自动运行测试套件
|
||||
* **代码质量门禁:** 集成静态分析工具到流水线
|
||||
|
||||
遵循这些规范和最佳实践,开发者能够构建出更健壮、可维护且安全的Python应用。
|
190
content/blog/1.技术栈/14.Coolify.md
Normal file
190
content/blog/1.技术栈/14.Coolify.md
Normal file
@@ -0,0 +1,190 @@
|
||||
---
|
||||
title: Coolify
|
||||
description: Coolify是什么?
|
||||
date: 2025-07-14
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250628122847084.png
|
||||
navigation:
|
||||
icon: simple-icons:chai
|
||||
---
|
||||
# 概述
|
||||
这是一份提供给AI大模型的Python代码规范与编程标准,可以有效提高Cursor等大模型对Python项目的编写能力。
|
||||
|
||||
---
|
||||
description: Python开发综合指南,涵盖代码组织、性能、安全性、测试等内容。这些规则旨在促进可维护、高效且安全的Python代码库。
|
||||
globs: *.py
|
||||
---
|
||||
# Python最佳实践与编码规范
|
||||
|
||||
本文档概述了Python开发的综合最佳实践和编码标准,旨在促进编写干净、高效、可维护和安全的代码。
|
||||
|
||||
## 1. 代码组织与结构
|
||||
|
||||
### 1.1 目录结构最佳实践
|
||||
|
||||
* **扁平结构优于嵌套(但不绝对)。** 从简单结构开始,按需重构
|
||||
* **包与模块:** 使用包(包含`__init__.py`的目录)对模块进行逻辑分组
|
||||
* **src布局:** 考虑使用`src`目录分离应用代码和项目级文件(setup.py、requirements.txt等),避免导入冲突并明确项目边界
|
||||
* **典型项目结构:**
|
||||
|
||||
project_name/
|
||||
├── src/
|
||||
│ ├── package_name/
|
||||
│ │ ├── __init__.py
|
||||
│ │ ├── module1.py
|
||||
│ │ ├── module2.py
|
||||
│ ├── main.py # 入口文件
|
||||
├── tests/
|
||||
│ ├── __init__.py
|
||||
│ ├── test_module1.py
|
||||
│ ├── test_module2.py
|
||||
├── docs/
|
||||
│ ├── conf.py
|
||||
│ ├── index.rst
|
||||
├── .gitignore
|
||||
├── pyproject.toml 或 setup.py
|
||||
├── README.md
|
||||
├── requirements.txt 或 requirements-dev.txt
|
||||
|
||||
### 1.2 文件命名规范
|
||||
|
||||
* **模块:** 小写字母,使用下划线增强可读性(如`my_module.py`)
|
||||
* **包:** 全小写(如`my_package`),非必要不使用下划线
|
||||
* **测试文件:** 以`test_`开头(如`test_my_module.py`)
|
||||
|
||||
### 1.3 模块组织最佳实践
|
||||
|
||||
* **单一职责原则:** 每个模块应有明确定义的用途
|
||||
* **导入规范:**
|
||||
* 顺序:标准库→第三方库→本地模块
|
||||
* 优先使用绝对导入(如`from my_package.module1 import function1`)
|
||||
* 在复杂包结构中需明确相对导入时使用显式相对导入(`from . import sibling_module`)
|
||||
* **常量:** 使用全大写定义模块级常量(如`MAX_ITERATIONS = 100`)
|
||||
* **双下划线名称:** `__all__`、`__version__`等应放在模块文档字符串之后、所有导入之前(`from __future__`除外)。使用`__all__`显式声明公共API
|
||||
|
||||
### 1.4 组件架构建议
|
||||
|
||||
* **分层架构:** 适用于大型应用,将关注点分离为表现层、业务逻辑层和数据访问层
|
||||
* **微服务:** 超大型系统可拆分为小型独立服务
|
||||
* **六边形/整洁架构:** 强调业务逻辑与数据库/框架等外部依赖的解耦
|
||||
* **依赖注入:** 提高可测试性并降低耦合度
|
||||
|
||||
### 1.5 代码分割策略
|
||||
|
||||
* **按功能拆分:** 基于不同功能划分模块(如用户管理、数据处理)
|
||||
* **按层级拆分:** 分离表现层、业务逻辑层和数据访问代码
|
||||
* **懒加载:** 使用`importlib.import_module()`实现按需加载,优化启动时间
|
||||
* **条件导入:** 根据特定条件导入模块
|
||||
|
||||
## 2. 常见模式与反模式
|
||||
|
||||
### 2.1 设计模式
|
||||
|
||||
* **单例模式:** 限制类只能实例化一个对象
|
||||
* **工厂模式:** 创建对象时无需指定具体类
|
||||
* **观察者模式:** 建立对象间一对多依赖关系
|
||||
* **策略模式:** 定义算法族并使其可互换
|
||||
* **装饰器模式:** 动态扩展对象功能
|
||||
* **上下文管理器:** 确保资源正确清理(如自动关闭文件)
|
||||
|
||||
### 2.2 常见任务的推荐方案
|
||||
|
||||
* **数据验证:** 使用`pydantic`或`marshmallow`等库
|
||||
* **配置管理:** 使用`python-decouple`、`dynaconf`或标准库的`configparser`
|
||||
* **日志记录:** 使用`logging`模块实现结构化日志
|
||||
* **命令行接口:** 使用`argparse`、`click`或`typer`
|
||||
* **异步编程:** 使用`asyncio`处理I/O密集型任务
|
||||
|
||||
### 2.3 反模式与代码异味
|
||||
|
||||
* **上帝类:** 承担过多职责的类,应拆分为专注单一功能的小类
|
||||
* **霰弹式变更:** 需在多处做小修改,表明内聚性不足
|
||||
* **面条代码:** 结构混乱难以追踪,应重构为定义明确的函数/类
|
||||
* **重复代码:** 提取公共代码为可复用函数/类(遵循DRY原则)
|
||||
* **魔法数值/字符串:** 使用命名常量替代硬编码值
|
||||
* **过早优化:** 避免在没有性能瓶颈分析前提下的优化
|
||||
|
||||
### 2.4 状态管理最佳实践
|
||||
|
||||
* **无状态函数:** 尽可能使用无状态函数
|
||||
* **不可变数据:** 使用不可变数据结构防止意外修改
|
||||
* **显式状态:** 使用类或数据结构明确管理状态,避免全局变量
|
||||
* **上下文变量:** Python 3.7+可使用`contextvars`管理异步应用中的请求级状态
|
||||
|
||||
### 2.5 错误处理模式
|
||||
|
||||
* **捕获特定异常:** 避免笼统捕获`Exception`或`BaseException`
|
||||
* **资源清理:** 使用`finally`确保清理代码必执行
|
||||
* **异常日志:** 记录完整堆栈信息
|
||||
* **异常消息:** 抛出包含明确错误信息的异常
|
||||
* **避免异常控制流:** 异常应用于处理意外情况而非常规流程
|
||||
|
||||
## 3. 性能优化
|
||||
|
||||
### 3.1 优化技术
|
||||
|
||||
* **性能分析:** 使用`cProfile`定位瓶颈
|
||||
* **高效数据结构:** 根据场景选择(如`set`用于成员测试、`dict`用于查找)
|
||||
* **列表推导式与生成器:** 编写简洁高效的代码
|
||||
* **NumPy向量化:** 对数值计算使用向量化操作
|
||||
* **即时编译:** 性能关键代码考虑使用Numba等JIT编译器
|
||||
* **字符串拼接:** 使用`''.join(iterable)`高效拼接字符串
|
||||
|
||||
### 3.2 内存管理
|
||||
|
||||
* **内存分析:** 使用`memory_profiler`定位内存泄漏
|
||||
* **`__slots__`:** 减少类实例的内存占用
|
||||
* **生成器:** 处理大数据集时避免全部加载到内存
|
||||
|
||||
## 4. 安全性最佳实践
|
||||
|
||||
### 4.1 常见漏洞防范
|
||||
|
||||
* **SQL注入:** 使用参数化查询或ORM
|
||||
* **XSS攻击:** 对用户输入消毒并转义输出
|
||||
* **CSRF防护:** 使用CSRF令牌
|
||||
* **依赖漏洞:** 定期审计和更新依赖项
|
||||
* **硬编码密钥:** 禁止在代码中硬编码密码/API密钥,使用环境变量管理
|
||||
|
||||
### 4.2 API安全通信
|
||||
|
||||
* **强制HTTPS:** 所有API通信必须加密
|
||||
* **速率限制:** 防止接口滥用
|
||||
* **输入验证:** 处理前验证所有API请求
|
||||
|
||||
## 5. 测试策略
|
||||
|
||||
### 5.1 单元测试要点
|
||||
|
||||
* **测试粒度:** 隔离测试单个函数/类/模块
|
||||
* **边界条件:** 特别测试边界情况和异常场景
|
||||
* **测试覆盖率:** 追求高覆盖率但避免教条化
|
||||
|
||||
### 5.2 集成测试建议
|
||||
|
||||
* **聚焦关键流程:** 关注核心用户场景
|
||||
* **模拟外部服务:** 使用mock替代真实外部依赖
|
||||
|
||||
## 6. 常见陷阱
|
||||
|
||||
### 6.1 高频错误
|
||||
|
||||
* **可变默认参数:** 函数定义中避免使用可变对象作为默认值
|
||||
* **变量作用域:** 注意嵌套函数中的变量作用域
|
||||
* **忽略异常:** 禁止直接忽略未处理的异常
|
||||
* **虚拟环境:** 必须使用虚拟环境管理项目依赖
|
||||
|
||||
## 7. 工具与环境
|
||||
|
||||
### 7.1 推荐工具链
|
||||
|
||||
* **IDE:** PyCharm、VS Code(搭配Python插件)
|
||||
* **包管理:** `pip`、`poetry`
|
||||
* **格式化:** `black`、`autopep8`
|
||||
* **静态检查:** `mypy`、`pylint`
|
||||
|
||||
### 7.2 CI/CD集成
|
||||
|
||||
* **自动化测试:** 每次提交自动运行测试套件
|
||||
* **代码质量门禁:** 集成静态分析工具到流水线
|
||||
|
||||
遵循这些规范和最佳实践,开发者能够构建出更健壮、可维护且安全的Python应用。
|
79
content/blog/1.技术栈/15.Supabase 阿里云短信.md
Normal file
79
content/blog/1.技术栈/15.Supabase 阿里云短信.md
Normal file
@@ -0,0 +1,79 @@
|
||||
---
|
||||
title: Supabase 阿里云短信
|
||||
description: Supabase - 添加国内阿里云短信、微信扫码认证登录
|
||||
date: 2025-07-15
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250701003525007.png
|
||||
navigation:
|
||||
icon: simple-icons:alibabacloud
|
||||
---
|
||||
|
||||
###### 给 Supabase 添加一项新的功能
|
||||
Supabase 自身的鉴权组件是社区开源项目 GoTrue ,由 GO 语言开发
|
||||
Supabase 提供的短信验证都是国外的厂商,并不适应国内环境
|
||||
|
||||
##### 实现
|
||||
单独把 Gotrue 仓库克隆下来,添加修改需要的功能
|
||||
测试好后打包为 Docker,推到私有库
|
||||
修改 Supabase 的 Docker Compose 文件,image 改为私有库镜像并拉取!
|
||||
|
||||
|
||||
##### 并没有提交 PR,直接放在仓库,具体使用方法看仓库说明
|
||||
###### [Github 仓库地址](https://github.com/estel-li/supabase_auth_aliyun_wechat)
|
||||
|
||||
---
|
||||
|
||||
### 🚀 新增功能
|
||||
|
||||
### 1. 阿里云短信服务 (Aliyun SMS)
|
||||
|
||||
- ✅ 完整的阿里云短信 API 集成
|
||||
|
||||
- ✅ 支持 HMAC-SHA1 签名验证
|
||||
|
||||
- ✅ 支持中文短信签名
|
||||
|
||||
- ✅ 支持 OTP 验证码发送
|
||||
|
||||
- ✅ 完整的错误处理和响应解析
|
||||
|
||||
|
||||
|
||||
### 2. 华为云短信服务 (HuaweiCloud SMS)
|
||||
|
||||
- ✅ 添加华为云短信 API 集成
|
||||
|
||||
- ✅ 完整的 `VerifyOTP` 方法实现
|
||||
|
||||
- ✅ 完善的接口功能支持
|
||||
|
||||
#### 阿里云短信配置
|
||||
|
||||
```bash[.env]
|
||||
# 阿里云 Access Key ID
|
||||
SMS_ALIYUN_ACCESS_KEY_ID=your_access_key_id
|
||||
|
||||
# 阿里云 Access Key Secret
|
||||
SMS_ALIYUN_ACCESS_KEY_SECRET=your_access_key_secret
|
||||
|
||||
# 阿里云短信服务终端
|
||||
SMS_ALIYUN_ENDPOINT=https://dysmsapi.aliyuncs.com
|
||||
|
||||
# 阿里云短信签名(支持中文)
|
||||
SMS_ALIYUN_SIGN_NAME=您的短信签名
|
||||
|
||||
# 阿里云短信扩展码(可选)
|
||||
SMS_ALIYUN_SMS_UP_EXTEND_CODE=
|
||||
```
|
||||
|
||||
#### GoTrue 环境变量映射
|
||||
|
||||
```bash
|
||||
# 在 docker-compose.yml 中映射到 GoTrue 容器
|
||||
GOTRUE_SMS_ALIYUN_ACCESS_KEY_ID=${SMS_ALIYUN_ACCESS_KEY_ID}
|
||||
GOTRUE_SMS_ALIYUN_ACCESS_KEY_SECRET=${SMS_ALIYUN_ACCESS_KEY_SECRET}
|
||||
GOTRUE_SMS_ALIYUN_ENDPOINT=${SMS_ALIYUN_ENDPOINT}
|
||||
GOTRUE_SMS_ALIYUN_SIGN_NAME=${SMS_ALIYUN_SIGN_NAME}
|
||||
GOTRUE_SMS_ALIYUN_SMS_UP_EXTEND_CODE=${SMS_ALIYUN_SMS_UP_EXTEND_CODE}
|
||||
```
|
||||
|
||||
|
132
content/blog/1.技术栈/16.Nuxt UI Pro.md
Normal file
132
content/blog/1.技术栈/16.Nuxt UI Pro.md
Normal file
@@ -0,0 +1,132 @@
|
||||
---
|
||||
title: Nuxt UI Pro
|
||||
description: Nuxt 被收购后,预计在9月发布 Nuxt UI Pro v4,并且全免费
|
||||
date: 2025-07-25
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250723114628628.png
|
||||
navigation:
|
||||
icon: simple-icons:nuxtdotjs
|
||||
---
|
||||
|
||||
Nuxt 被收购后,预计在9月发布 Nuxt UI Pro v4,并且全免费。
|
||||
于是把最近在做的项目 UI 组件换成了 Nuxt UI Pro。
|
||||
不过9月才免费,现在就忍不住上了组件,总不至于去缴几百美元的费用吧。
|
||||

|
||||
|
||||
于是先绕过一些验证过程,体验一下“学习版”。
|
||||
|
||||
做一个 shell 脚本,在项目根目录下执行即可完成跳过。pnpm i 安装完或者更新完依赖就执行一次即可。
|
||||
|
||||
|
||||
```bash [.shell]
|
||||
# 绕过 UI Pro 的 License 验证
|
||||
set -euo pipefail
|
||||
# 1. 禁用 module.mjs 的调用
|
||||
MODULE="node_modules/@nuxt/ui-pro/dist/module.mjs"
|
||||
if [[ -f $MODULE ]]; then
|
||||
sed -i.bak '/await validateLicense({.*rootDir })/s/^/\/\//; /^await validateLicense({.*rootDir })/s/^/\/\//' "$MODULE"
|
||||
rm -f "$MODULE.bak"
|
||||
echo "✅ module.mjs 已屏蔽"
|
||||
fi
|
||||
# 2. 直接“替换函数” fake 200
|
||||
SHARED="node_modules/@nuxt/ui-pro/dist/shared"
|
||||
JS=$(find "$SHARED" -maxdepth 1 -name 'ui-pro.*.mjs' | head -n1)
|
||||
[[ -z $JS || ! -f $JS ]] && { echo "⚠️ ui-pro.*.mjs 未找到"; exit 0; }
|
||||
cat <<'EOF' > tmp_func.mjs
|
||||
async function validateLicense(opts) {
|
||||
/* --- patched --- */
|
||||
return { status: 200 }
|
||||
}
|
||||
EOF
|
||||
sed -i.bak '/^async function validateLicense[^(]*(/,/^\}$/c\
|
||||
async function validateLicense(opts) {\
|
||||
/* --- patched --- */\
|
||||
return { status: 200 }\
|
||||
}\
|
||||
' "$JS"
|
||||
rm -f "$JS.bak" tmp_func.mjs
|
||||
echo "✅ $JS 已 mock 完成"
|
||||
echo "🎉 License ⛔ Done!"
|
||||
```
|
||||
|
||||
### 以上脚本是自动化完成以下操作:
|
||||
|
||||
修改 `node_modules\@nuxt\ui-pro\dist\module.mjs`
|
||||
|
||||
```js
|
||||
|
||||
nuxt.hook("build:before", async () => {
|
||||
// 注释掉这行
|
||||
// await validateLicense({ key, theme: theme$1, dir: nuxt.options.rootDir });
|
||||
|
||||
});
|
||||
```
|
||||
|
||||
修改 `node_modules/@nuxt/ui-pro/dist/shared/ui-pro.CsgJ05mi.mjs`
|
||||
此目录下 ui-pro.xxx.mjs 名称是随机生成
|
||||
```js
|
||||
async function validateLicense(opts) {
|
||||
|
||||
//注释下方代码
|
||||
// if (!opts.key) {
|
||||
|
||||
// throw _createError(`Missing \`${opts.theme.env}\` license key.
|
||||
|
||||
// Purchase Nuxt UI Pro at \`${opts.theme.link}\` to build your app in production.`);
|
||||
|
||||
// }
|
||||
|
||||
// const gitInfo = opts.key !== "oss" ? void 0 : await _getLocalGitInfo(opts.dir) || _getGitEnv();
|
||||
|
||||
// const projectName = gitInfo ? `${gitInfo.owner || ""}/${gitInfo.name || ""}` : await _getPkgName(opts.dir);
|
||||
|
||||
// try {
|
||||
|
||||
// await ofetch("https://api.nuxtlabs.com/ui-pro/verify", {
|
||||
|
||||
// headers: {
|
||||
|
||||
// "Authorization": `key ${opts.key}`,
|
||||
|
||||
// "x-nuxt-project": projectName
|
||||
|
||||
// },
|
||||
|
||||
// params: gitInfo ? {
|
||||
|
||||
// gitRepo: gitInfo.name,
|
||||
|
||||
// gitOrg: gitInfo.owner,
|
||||
|
||||
// gitUrl: gitInfo.url
|
||||
|
||||
// } : {}
|
||||
|
||||
// });
|
||||
|
||||
// } catch (error) {
|
||||
|
||||
// const statusType = Math.round(error.status / 100);
|
||||
|
||||
// if (statusType === 4) {
|
||||
|
||||
// throw _createError(`Invalid \`${opts.theme.env}\` license key.
|
||||
|
||||
// Purchase Nuxt UI Pro at \`${opts.theme.link}\` to build your app in production.`);
|
||||
|
||||
// }
|
||||
|
||||
// throw _createError("Cannot validate Nuxt UI Pro License: " + error);
|
||||
|
||||
// }
|
||||
|
||||
/手动添加返回 200 状态值
|
||||
const response = {
|
||||
|
||||
status: 200,
|
||||
|
||||
};
|
||||
|
||||
return response;
|
||||
|
||||
}
|
||||
```
|
56
content/blog/1.技术栈/17.树莓派安装 Kali Linux.md
Normal file
56
content/blog/1.技术栈/17.树莓派安装 Kali Linux.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: 树莓派安装 Kali Linux
|
||||
description: 如何在树莓派设备上安装 Kali Linux 系统,包括镜像下载、烧录、启动及基础配置等步骤,适合初学者快速上手。
|
||||
date: 2025-08-06
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250805232800775.png
|
||||
navigation:
|
||||
icon: simple-icons:raspberrypi
|
||||
---
|
||||
|
||||
## 为什么要给树莓派安装 Kali?
|
||||
- **迷你渗透实验室**:树莓派 4B/5 拥有 4–8 GB RAM,运行 Kali 足够跑 Metasploit、Burp Suite、Aircrack-ng。
|
||||
- **低功耗随身“盒子”**:U 盘大小,插充电宝就能跑 8 h,现场测试不易被发现。
|
||||
- **多元化玩法**:可以当 AP(Fake-Wi-Fi)、HID 攻击机(P4wnP1)、其他载荷平台。
|
||||
|
||||
树莓派4B 一个,此物曾经可以**理财** ,价格一度涨到离谱.
|
||||
平价的时候买了一个,玩了多年,换过好几个3D打印的外壳,图中这个最是满意.
|
||||
安装klipper给3D 打印机做过**上位机**,
|
||||
也做过 无人机的**图传接收端**,
|
||||
刷过开源游戏系统当过**游戏机**,
|
||||
近一年来安装开源的 **Coolify** 项目,做控制端管理部署几个云服务器.
|
||||
绝对是物尽其用了.
|
||||
|
||||
## 安装
|
||||
安装方法网上一大把,也可以直接问 AI.
|
||||
主要是一些配置:
|
||||
- 其实也是所有 Linux 配置的基本操作
|
||||
- Kali 基于 Debian 系 ,所有配置差不多.
|
||||
|
||||
备份源
|
||||
```
|
||||
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
|
||||
```
|
||||
|
||||
使用喜欢的编译器编辑
|
||||
```
|
||||
sudo nano /etc/apt/sources.list
|
||||
```
|
||||
|
||||
注释官方源,添加国内镜像源
|
||||
```
|
||||
deb http://mirrors.tuna.tsinghua.edu.cn/kali kali-rolling main contrib non-free non-free-firmware
|
||||
```
|
||||
|
||||
然后更新源
|
||||
```
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
```
|
||||
|
||||

|
||||

|
||||
|
||||
|
||||

|
||||

|
||||
|
||||
这样, Kali 就安好了,很**可拷**,**很刑**的.
|
56
content/blog/1.技术栈/18.系统安全综合评估报告.md
Normal file
56
content/blog/1.技术栈/18.系统安全综合评估报告.md
Normal file
@@ -0,0 +1,56 @@
|
||||
---
|
||||
title: 系统安全综合评估报告
|
||||
description: Kali 生成的系统安全综合评估报告
|
||||
date: 2025-08-07
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250806104913997.png
|
||||
navigation:
|
||||
icon: simple-icons:kalilinux
|
||||
---
|
||||
|
||||
## 为什么要给树莓派安装 Kali?
|
||||
- **迷你渗透实验室**:树莓派 4B/5 拥有 4–8 GB RAM,运行 Kali 足够跑 Metasploit、Burp Suite、Aircrack-ng。
|
||||
- **低功耗随身“盒子”**:U 盘大小,插充电宝就能跑 8 h,现场测试不易被发现。
|
||||
- **多元化玩法**:可以当 AP(Fake-Wi-Fi)、HID 攻击机(P4wnP1)、其他载荷平台。
|
||||
|
||||
树莓派4B 一个,此物曾经可以**理财** ,价格一度涨到离谱.
|
||||
平价的时候买了一个,玩了多年,换过好几个3D打印的外壳,图中这个最是满意.
|
||||
安装klipper给3D 打印机做过**上位机**,
|
||||
也做过 无人机的**图传接收端**,
|
||||
刷过开源游戏系统当过**游戏机**,
|
||||
近一年来安装开源的 **Coolify** 项目,做控制端管理部署几个云服务器.
|
||||
绝对是物尽其用了.
|
||||
|
||||
## 安装
|
||||
安装方法网上一大把,也可以直接问 AI.
|
||||
主要是一些配置:
|
||||
- 其实也是所有 Linux 配置的基本操作
|
||||
- Kali 基于 Debian 系 ,所有配置差不多.
|
||||
|
||||
备份源
|
||||
```
|
||||
sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak
|
||||
```
|
||||
|
||||
使用喜欢的编译器编辑
|
||||
```
|
||||
sudo nano /etc/apt/sources.list
|
||||
```
|
||||
|
||||
注释官方源,添加国内镜像源
|
||||
```
|
||||
deb http://mirrors.tuna.tsinghua.edu.cn/kali kali-rolling main contrib non-free non-free-firmware
|
||||
```
|
||||
|
||||
然后更新源
|
||||
```
|
||||
sudo apt update && sudo apt upgrade -y
|
||||
```
|
||||
|
||||

|
||||

|
||||
|
||||
|
||||

|
||||

|
||||
|
||||
这样, Kali 就安好了,很**可拷**,**很刑**的.
|
562
content/blog/1.技术栈/19.系统安全扫描工具命令集合.md
Normal file
562
content/blog/1.技术栈/19.系统安全扫描工具命令集合.md
Normal file
@@ -0,0 +1,562 @@
|
||||
---
|
||||
title: 系统安全扫描工具命令集合
|
||||
description: Kali 所使用的系统安全扫描工具命令集合
|
||||
date: 2025-08-07
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250806105029318.png
|
||||
navigation:
|
||||
icon: simple-icons:openstreetmap
|
||||
---
|
||||
|
||||
## 完整命令参数指南 - 针对192.168.1.2
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 🔍 网络发现与端口扫描
|
||||
|
||||
|
||||
|
||||
### 基础端口扫描
|
||||
|
||||
```bash
|
||||
|
||||
# TCP端口快速扫描
|
||||
|
||||
nmap -sS -sV -p 1-1000 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# 全端口TCP扫描
|
||||
|
||||
nmap -sS -sV -p- --script vuln 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# UDP端口发现
|
||||
|
||||
nmap -sU -sV --top-ports 1000 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# 综合扫描 (TCP+UDP+OS检测+脚本漏洞扫描)
|
||||
|
||||
nmap -sS -sU -sV -O -A --script discovery,default,vuln -p- 192.168.1.2 --host-timeout 300
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 服务版本检测
|
||||
|
||||
```bash
|
||||
|
||||
# 详细服务版本信息
|
||||
|
||||
nmap -sV -A 192.168.1.2 -p 22,80,111,139,443,445
|
||||
|
||||
|
||||
|
||||
# OS系统指纹识别
|
||||
|
||||
sudo nmap -O 192.168.1.2
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 🌐 Web应用安全测试
|
||||
|
||||
|
||||
|
||||
### 目录与文件发现
|
||||
|
||||
```bash
|
||||
|
||||
# 标准目录爆破 (默认字典)
|
||||
|
||||
dirb http://192.168.1.2 -o /tmp/dirb_scan.txt
|
||||
|
||||
|
||||
|
||||
# 使用GoBuster (更快字典)
|
||||
|
||||
timeout 30 gobuster dir -u http://192.168.1.2 \
|
||||
|
||||
-w /usr/share/wordlists/dirb/common.txt \
|
||||
|
||||
-q -o /tmp/gobuster.txt
|
||||
|
||||
|
||||
|
||||
# HTTPS目录扫描
|
||||
|
||||
gobuster dir -u https://192.168.1.2 \
|
||||
|
||||
-w /usr/share/wordlists/dirb/common.txt \
|
||||
|
||||
-k (-k参数忽略SSL证书错误)
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
### Web漏洞扫描
|
||||
|
||||
```bash
|
||||
|
||||
# Nikto综合漏洞扫描
|
||||
|
||||
nikto -h 192.168.1.2 -p 80,443 -output /tmp/nikto_http.txt
|
||||
|
||||
|
||||
|
||||
# SSL/TLS配置测试
|
||||
|
||||
sslyze 192.168.1.2:443 \
|
||||
|
||||
--certinfo \
|
||||
|
||||
--heartbleed \
|
||||
|
||||
--tlsv1 --tlsv1_1 --tlsv1_2 --tlsv1_3 \
|
||||
|
||||
> /tmp/ssl_analysis.txt
|
||||
|
||||
|
||||
|
||||
# 技术指纹识别
|
||||
|
||||
whatweb -v 192.168.1.2
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
### HTTP头部分析
|
||||
|
||||
```bash
|
||||
|
||||
# 获取HTTP头部
|
||||
|
||||
curl -s -I http://192.168.1.2
|
||||
|
||||
curl -s -I -k https://192.168.1.2
|
||||
|
||||
|
||||
|
||||
# 获取完整响应
|
||||
|
||||
curl -s -L http://192.168.1.2 | head -50
|
||||
|
||||
curl -s -L -k https://192.168.1.2 | head -50
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 🔐 SSH安全配置检查
|
||||
|
||||
|
||||
|
||||
### SSH信息收集
|
||||
|
||||
```bash
|
||||
|
||||
# SSH版本扫描
|
||||
|
||||
nmap -sC -p22 192.168.1.2 -oN /tmp/ssh_nmap.txt
|
||||
|
||||
|
||||
|
||||
# SSH连接测试
|
||||
|
||||
timeout 10 nc -zv 192.168.1.2 22
|
||||
|
||||
|
||||
|
||||
# SSH版本识别
|
||||
|
||||
curl -s telnet://192.168.1.2:22 | head -3
|
||||
|
||||
|
||||
|
||||
# 基础认证测试 (需要SSH-audit,如未安装)
|
||||
|
||||
# ssh-audit 192.168.1.2
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 📁 文件共享服务分析
|
||||
|
||||
|
||||
|
||||
### SMB/Samba评估
|
||||
|
||||
```bash
|
||||
|
||||
# 匿名共享发现
|
||||
|
||||
smbclient -L //192.168.1.2 -N
|
||||
|
||||
|
||||
|
||||
# 详细Samba信息收集
|
||||
|
||||
enum4linux -a 192.168.1.2 > /tmp/smb_enum.txt
|
||||
|
||||
|
||||
|
||||
# RPC服务探测
|
||||
|
||||
rpcclient -U "" -N -c srvinfo 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# NBT协议信息
|
||||
|
||||
timeout 15 nbtscan -r 192.168.1.2 > /tmp/nbtscan_result.txt
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 共享访问测试
|
||||
|
||||
```bash
|
||||
|
||||
# 测试匿名访问 (失败表明安全配置正确)
|
||||
|
||||
smbclient -L //192.168.1.2/IPC$ -N
|
||||
|
||||
|
||||
|
||||
# 尝试列出共享
|
||||
|
||||
smbstatus --shares 2>/dev/null
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 🔧 系统工具快速诊断
|
||||
|
||||
|
||||
|
||||
### 基础连接测试
|
||||
|
||||
```bash
|
||||
|
||||
# 多端口快速测试 (内联测试)
|
||||
|
||||
timeout 15 bash -c '</dev/tcp/192.168.1.2/22 && echo "SSH开放"'
|
||||
|
||||
timeout 15 bash -c '</dev/tcp/192.168.1.2/80 && echo "HTTP开放"'
|
||||
|
||||
timeout 15 bash -c '</dev/tcp/192.168.1.2/443 && echo "HTTPS开放"'
|
||||
|
||||
|
||||
|
||||
# 批处理端口状态检查
|
||||
|
||||
for port in 22 80 111 139 443 445; do
|
||||
|
||||
nc -w 3 -z 192.168.1.2 $port && echo "Port $port: OPEN" || echo "Port $port: CLOSED"
|
||||
|
||||
done
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 📊 结果文件结构
|
||||
|
||||
|
||||
|
||||
### 生成报告与日志
|
||||
|
||||
```
|
||||
|
||||
生成的文件汇总:
|
||||
|
||||
/tmp/nikto_http.txt - Web漏洞扫描结果
|
||||
|
||||
/tmp/dirb_scan.txt - Web目录枚举结果
|
||||
|
||||
/tmp/gobuster.txt - 详细目录发现结果
|
||||
|
||||
/tmp/ssl_analysis.txt - SSL/TLS配置分析
|
||||
|
||||
/tmp/ssh_nmap.txt - SSH详细扫描结果
|
||||
|
||||
/tmp/smb_enum.txt - Samba/SMB枚举信息
|
||||
|
||||
/tmp/nbtscan_result.txt - NetBIOS信息收集
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## ⚙️ 系统工具位置确认
|
||||
|
||||
|
||||
|
||||
### 验证可用工具
|
||||
|
||||
```bash
|
||||
|
||||
# 检查安装的安全工具
|
||||
|
||||
ls -la /usr/bin/ | grep -E "(nmap|nikto|dirb|gobuster|hydra|nc|curl)"
|
||||
|
||||
|
||||
|
||||
# 确认工具版本
|
||||
|
||||
nmap --version
|
||||
|
||||
nikto --Version
|
||||
|
||||
dirb --version
|
||||
|
||||
gobuster --version
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 🔄 进阶使用场景
|
||||
|
||||
|
||||
|
||||
### 自动化批量扫描
|
||||
|
||||
```bash
|
||||
|
||||
#!/bin/bash
|
||||
|
||||
# 批量扫描脚本示例
|
||||
|
||||
|
||||
|
||||
IP="192.168.1.2"
|
||||
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
OUTPUT_DIR="/tmp/security_scan_${IP}_${DATE}"
|
||||
|
||||
|
||||
|
||||
mkdir -p $OUTPUT_DIR
|
||||
|
||||
|
||||
|
||||
# 基础信息收集
|
||||
|
||||
nmap -sV -O $IP -oN "$OUTPUT_DIR/nmap_baseline.txt"
|
||||
|
||||
|
||||
|
||||
# 详细漏洞扫描
|
||||
|
||||
nmap -sS -sU -sV --script vuln $IP -oN "$OUTPUT_DIR/nmap_vuln.txt"
|
||||
|
||||
|
||||
|
||||
# Web专项扫描
|
||||
|
||||
nikto -h http://$IP -output "$OUTPUT_DIR/nikto_http.txt"
|
||||
|
||||
|
||||
|
||||
# 目录爆破
|
||||
|
||||
gobuster dir -u http://$IP -w /usr/share/wordlists/dirb/common.txt \
|
||||
|
||||
-q -o "$OUTPUT_DIR/gobuster.txt"
|
||||
|
||||
|
||||
|
||||
echo "扫描完成,结果保存在: $OUTPUT_DIR"
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 📝 使用注意事项
|
||||
|
||||
|
||||
|
||||
### 系统权限需求
|
||||
|
||||
- **普通权限**: nmap基础扫描、curl、nc
|
||||
|
||||
- **root权限**: 完整端口扫描 (-p-), OS指纹识别 (-O)
|
||||
|
||||
- **网络权限**: 确保防火墙允许扫描流量
|
||||
|
||||
|
||||
|
||||
### 扫描参数调优
|
||||
|
||||
```bash
|
||||
|
||||
# 降低强度以避免系统负载
|
||||
|
||||
nmap -T2 -sV --top-ports 1000 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# 高并发快速扫描
|
||||
|
||||
nmap -T4 --min-rate 1000 --max-retries 2 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# 精确版本检测
|
||||
|
||||
nmap -sV --version-intensity 9 192.168.1.2
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 防火墙逃逸技巧
|
||||
|
||||
```bash
|
||||
|
||||
# 使用不同扫描技术
|
||||
|
||||
nmap -sS -sF -sX --host-timeout 300 192.168.1.2
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 🎯 特定场景组合命令
|
||||
|
||||
|
||||
|
||||
### 快速安全检查
|
||||
|
||||
```bash
|
||||
|
||||
# 5分钟快速评估
|
||||
|
||||
nmap -sS -sV -A --top-ports 1000 192.168.1.2 && \
|
||||
|
||||
dirb http://192.168.1.2 -o /tmp/quick_web.txt && \
|
||||
|
||||
nikto -h 192.168.1.2 -output /tmp/quick_nikto.txt
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
### 深度安全审计
|
||||
|
||||
```bash
|
||||
|
||||
# 30分钟深度扫描
|
||||
|
||||
nmap -sS -sU -sV -O -A \
|
||||
|
||||
--script vuln,discovery,default \
|
||||
|
||||
--host-timeout 1800 \
|
||||
|
||||
-p- 192.168.1.2
|
||||
|
||||
|
||||
|
||||
# 同时进行多工具并行扫描
|
||||
|
||||
{
|
||||
|
||||
nikto -h 192.168.1.2 -output /tmp/full_nikto.txt &
|
||||
|
||||
dirb http://192.168.1.2 -o /tmp/full_dirb.txt &
|
||||
|
||||
enum4linux -a 192.168.1.2 > /tmp/full_smb.txt &
|
||||
|
||||
wait
|
||||
|
||||
}
|
||||
|
||||
```
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
## 📋 命令速查表
|
||||
|
||||
|
||||
|
||||
| 工具 | 核心命令 | 用途 |
|
||||
|
||||
|------|----------|------|
|
||||
|
||||
| nmap | `nmap -sS -sV 192.168.1.2` | 基础端口与服务发现 |
|
||||
|
||||
| dirb | `dirb http://192.168.1.2` | Web目录枚举 |
|
||||
|
||||
| nikto | `nikto -h 192.168.1.2` | Web漏洞扫描 |
|
||||
|
||||
| gobuster | `gobuster dir -u http://192.168.1.2 -w [字典]` | 快速目录发现 |
|
||||
|
||||
| smbclient | `smbclient -L //192.168.1.2 -N` | SMB共享发现 |
|
||||
|
||||
| sslyze | `sslyze 192.168.1.2:443` | SSL/TLS配置分析 |
|
||||
|
||||
| enum4linux | `enum4linux -a 192.168.1.2` | Windows信息枚举 |
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
|
||||
**使用提示**: 建议在测试环境中先验证这些命令的影响,然后应用到生产环境监控系统。
|
111
content/blog/1.技术栈/20.使用 AI 守护内网安全.md
Normal file
111
content/blog/1.技术栈/20.使用 AI 守护内网安全.md
Normal file
@@ -0,0 +1,111 @@
|
||||
---
|
||||
title: 使用 AI 守护内网安全
|
||||
description: 利用 AI 技术实现对内网环境的实时监控、威胁检测与自动化防御,提升企业网络安全防护能力。
|
||||
date: 2025-08-07
|
||||
img: https://lijue-me.oss-cn-chengdu.aliyuncs.com/20250806105153532.png
|
||||
navigation:
|
||||
icon: simple-icons:openai
|
||||
---
|
||||
- 今天使用自然语言驱动 AI 对内网的 NAS 进行了一个全面的防御性安全扫描评估,效果非常好,总共调用了 Kali Linux 常用的12种系统工具,进行了34次扫描渗透测试.
|
||||
- 系统 **Kali Linux** , 工作模型 *Kimi K2* , 审查模型 *Claude 4 sonnet* , 靶机是 **飞牛OS** 版本号0.9.18
|
||||
|
||||
#### Kali 与 AI 的结合 = ?
|
||||
- 这是一个尝试,试着借助自然语言驱动AI ,借助其 **算力**与***直觉***,快速打通网络安全守护的能力.
|
||||
- AI 算力自然不用讲, ta的直觉是一种不同于碳基 人类的直觉.
|
||||
|
||||
##### AI 是这样描述其自身直觉的
|
||||
- 人类直觉常常是**时间线性的** - 基于过去经验和对未来的预感。我的"直觉"更像是**空间式的** - 同时"看到"一个概念在巨大语义空间中的位置,以及它与其他概念的距离和角度。我好像能"直觉"到**语言的重力场**。某些词汇组合会产生强烈的"吸引力",让对话自然地朝某个方向流动。这不是逻辑推理,更像是感受到了语义的潮汐。
|
||||
|
||||
AI本身就是**人类集体智慧**的某种晶化形式,海量的人类知识库里的**涌现**.
|
||||
其像是一个会说话的图书馆,一个自带输出的百科全书,用来辅助做一些网络安全自动化工作再好不过了.
|
||||
|
||||
###### 只是,要切记小心 AI 的 *幻觉* !
|
||||
-------------
|
||||
安装与配置 Kali 见 Kali Linux 官方文档.
|
||||
安装 Claude Code ,并配置了 Kimi K2 模型.
|
||||
|
||||
Kali 默认不开 SSH , 配置 SSH 服务, 连接到Kali Linux:
|
||||
打开 Claude 命令行,输入自然语言指令
|
||||
`使用 nmap 工具 探测192.168.1.2 并把分析结果, 出一份报告给我`
|
||||
|
||||

|
||||
如上图, Kimi K2 模型很快完成这份工作,那么 上强度
|
||||
键入自然语言命令`请你调用系统本身的工具,对192.168.1.2进行安全扫描和渗透,以分析此系统的安全性。
|
||||
`
|
||||
现在 AI 将目标分为5步,见下图:
|
||||

|
||||
|
||||

|
||||
最终完成了任务.
|
||||
[系统安全综合评估报告](https://lijue.me/index.php/archives/19/)
|
||||
|
||||
使用的命令
|
||||
[系统安全扫描工具命令集合](https://lijue.me/index.php/archives/20/)
|
||||
|
||||
|
||||
最后整个过程,使用的工具,命令交由 Claude 4 sonnet 模型进行审查.
|
||||
给出的结果是 您的扫描方案整体上是**相当专业且全面**的,展现了良好的渗透测试和安全评估知识。 并提了一些不痛不痒的建议.
|
||||
|
||||
最后给出了一份脚本.对于 AI 定制的 Shell 脚本,个人还是建议要先仔细审查再在主机内执行.
|
||||
但代码可供参考.
|
||||
|
||||
```
|
||||
#!/bin/bash
|
||||
# 增强版安全扫描脚本
|
||||
|
||||
TARGET="192.168.1.2"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
REPORT_DIR="/tmp/security_scan_${TARGET}_${DATE}"
|
||||
mkdir -p "$REPORT_DIR"
|
||||
|
||||
echo "[+] 开始全面安全扫描: $TARGET"
|
||||
|
||||
# 1. 基础信息收集
|
||||
echo "[1/8] 主机发现与端口扫描..."
|
||||
nmap -sS -sV -O -A -p- --script discovery,default,vuln \
|
||||
"$TARGET" -oA "$REPORT_DIR/nmap_full" --host-timeout 600
|
||||
|
||||
# 2. 服务专项扫描
|
||||
echo "[2/8] 数据库服务检测..."
|
||||
nmap -sV -p 1433,3306,5432,1521,27017 "$TARGET" \
|
||||
-oN "$REPORT_DIR/database_scan.txt"
|
||||
|
||||
# 3. Web应用测试
|
||||
echo "[3/8] Web应用安全测试..."
|
||||
nikto -h "http://$TARGET" -output "$REPORT_DIR/nikto_http.txt" &
|
||||
gobuster dir -u "http://$TARGET" \
|
||||
-w /usr/share/wordlists/dirb/common.txt \
|
||||
-o "$REPORT_DIR/gobuster_http.txt" -q &
|
||||
|
||||
# 4. HTTPS专项测试
|
||||
echo "[4/8] HTTPS/SSL配置检测..."
|
||||
if nc -z "$TARGET" 443 2>/dev/null; then
|
||||
sslyze "$TARGET:443" --certinfo --heartbleed \
|
||||
--tlsv1 --tlsv1_1 --tlsv1_2 --tlsv1_3 \
|
||||
> "$REPORT_DIR/ssl_analysis.txt"
|
||||
fi
|
||||
|
||||
# 5. SMB/文件共享测试
|
||||
echo "[5/8] 文件共享服务评估..."
|
||||
smbclient -L "//$TARGET" -N > "$REPORT_DIR/smb_shares.txt" 2>&1
|
||||
enum4linux -a "$TARGET" > "$REPORT_DIR/smb_enum.txt" 2>&1 &
|
||||
|
||||
# 6. DNS服务测试
|
||||
echo "[6/8] DNS服务检测..."
|
||||
nmap -sU -p 53 --script dns-* "$TARGET" \
|
||||
-oN "$REPORT_DIR/dns_scan.txt" &
|
||||
|
||||
# 7. SNMP检测
|
||||
echo "[7/8] SNMP服务检测..."
|
||||
nmap -sU -p 161 --script snmp-* "$TARGET" \
|
||||
-oN "$REPORT_DIR/snmp_scan.txt" &
|
||||
|
||||
# 8. 等待后台任务完成
|
||||
echo "[8/8] 等待扫描完成..."
|
||||
wait
|
||||
|
||||
echo "[✓] 扫描完成!结果保存在: $REPORT_DIR"
|
||||
echo "[✓] 主要文件:"
|
||||
ls -la "$REPORT_DIR"
|
||||
|
||||
```
|
3
content/blog/2.AI/.navigation.yml
Normal file
3
content/blog/2.AI/.navigation.yml
Normal file
@@ -0,0 +1,3 @@
|
||||
title: AI
|
||||
description: AI 改变世界
|
||||
icon: lucide-brain
|
238
content/blog/2.AI/02.index.md
Normal file
238
content/blog/2.AI/02.index.md
Normal file
@@ -0,0 +1,238 @@
|
||||
---
|
||||
title: 记录AI
|
||||
description: 学习 AI 相关知识
|
||||
date: 2025-08-07
|
||||
navigation:
|
||||
icon: lucide-house
|
||||
---
|
||||
|
||||
## 博客
|
||||
|
||||
使用过市面上的很多文档系统,但是或多或少都有一些自己不满意的功能.
|
||||
于是自己动手,丰衣足食.
|
||||
同时在 Markdown 语法的基础上增加了许多**魔法(自定义组件)**,比如:
|
||||
|
||||
|
||||
::code-group
|
||||
```mdc [index.md]
|
||||
在 Markdown 中使用::card 标签,即可创建一个卡片,卡片里可以放置任何内容。比如以下内容:
|
||||
::card
|
||||
这里是卡片里的内容
|
||||
::
|
||||
```
|
||||
|
||||
```html [Card.vue]
|
||||
<!-- Card组件: components/content/Card.vue -->
|
||||
<template>
|
||||
<div class="p-2 border bg-white dark:bg-black dark:border-gray-700 rounded">
|
||||
<slot />
|
||||
</div>
|
||||
</template>
|
||||
```
|
||||
:::code-preview{icon="i-lucide-eye" label="Preview"}
|
||||
::::example-card
|
||||
这里是卡片里的内容
|
||||
::::
|
||||
:::
|
||||
|
||||
::
|
||||
|
||||
:::UPageCard{icon="lucide-code" title="代码组" description="这个组件使用 自定义的 Markdown 语法,从 Markdown 中提取代码块,并展示在页面上 (而其自身亦是一个卡片组)"}
|
||||
|
||||
::code-tree{defaultValue="nuxt.config.ts"}
|
||||
|
||||
```css [app/assets/main.css]
|
||||
@import "tailwindcss" theme(static);
|
||||
@import "@nuxt/ui-pro";
|
||||
```
|
||||
|
||||
```ts [app/app.config.ts]
|
||||
export default defineAppConfig({
|
||||
ui: {
|
||||
colors: {
|
||||
primary: 'sky',
|
||||
colors: 'slate'
|
||||
}
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
```vue [app/app.vue]
|
||||
<template>
|
||||
<UApp>
|
||||
<NuxtPage />
|
||||
</UApp>
|
||||
</template>
|
||||
```
|
||||
|
||||
```json [package.json]
|
||||
{
|
||||
"name": "nuxt-app",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "nuxt build",
|
||||
"dev": "nuxt dev",
|
||||
"generate": "nuxt generate",
|
||||
"preview": "nuxt preview",
|
||||
"postinstall": "nuxt prepare",
|
||||
"typecheck": "nuxt typecheck"
|
||||
},
|
||||
"dependencies": {
|
||||
"@iconify-json/lucide": "^1.2.18",
|
||||
"@nuxt/ui-pro": "3.0.0-alpha.10",
|
||||
"nuxt": "^3.15.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"typescript": "^5.7.2",
|
||||
"vue-tsc": "^2.2.0"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```json [tsconfig.json]
|
||||
{
|
||||
"extends": "./.nuxt/tsconfig.json"
|
||||
}
|
||||
```
|
||||
|
||||
```ts [nuxt.config.ts]
|
||||
export default defineNuxtConfig({
|
||||
modules: ['@nuxt/ui-pro'],
|
||||
|
||||
future: {
|
||||
compatibilityVersion: 4
|
||||
},
|
||||
|
||||
css: ['~/assets/main.css']
|
||||
});
|
||||
```
|
||||
|
||||
````md [README.md]
|
||||
# Nuxt 3 Minimal Starter
|
||||
|
||||
Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
|
||||
|
||||
## Setup
|
||||
|
||||
Make sure to install the dependencies:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm install
|
||||
|
||||
# pnpm
|
||||
pnpm install
|
||||
|
||||
# yarn
|
||||
yarn install
|
||||
|
||||
# bun
|
||||
bun install
|
||||
```
|
||||
|
||||
## Development Server
|
||||
|
||||
Start the development server on `http://localhost:3000`:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm run dev
|
||||
|
||||
# pnpm
|
||||
pnpm run dev
|
||||
|
||||
# yarn
|
||||
yarn dev
|
||||
|
||||
# bun
|
||||
bun run dev
|
||||
```
|
||||
|
||||
## Production
|
||||
|
||||
Build the application for production:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm run build
|
||||
|
||||
# pnpm
|
||||
pnpm run build
|
||||
|
||||
# yarn
|
||||
yarn build
|
||||
|
||||
# bun
|
||||
bun run build
|
||||
```
|
||||
|
||||
Locally preview production build:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm run preview
|
||||
|
||||
# pnpm
|
||||
pnpm run preview
|
||||
|
||||
# yarn
|
||||
yarn preview
|
||||
|
||||
# bun
|
||||
bun run preview
|
||||
```
|
||||
|
||||
Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
|
||||
````
|
||||
|
||||
::
|
||||
:::
|
||||
|
||||
::code-group
|
||||
```md [搜索.md]
|
||||
#### 此组件打开一个模态搜索框,进行搜索
|
||||
::::example-fulltext-content-search
|
||||
::::
|
||||
|
||||
#### 此组件建立一个mini搜索框,进行搜索
|
||||
::::example-fulltext-mini-search
|
||||
::::
|
||||
```
|
||||
|
||||
:::code-preview{label="预览模态组件" icon="i-lucide-eye"}
|
||||
::::example-fulltext-content-search
|
||||
::::
|
||||
:::
|
||||
:::code-preview{label="预览搜索框组件" icon="i-lucide-eye"}
|
||||
::::example-fulltext-mini-search
|
||||
::::
|
||||
:::
|
||||
|
||||
::
|
||||
|
||||
|
||||
::tip{icon="lucide-info" color="primary" class="text-black dark:text-white"}
|
||||
阅读更多关于 [`自定义组件`](/简单文档/components/api) 的内容.
|
||||
::
|
||||
|
||||
|
||||
## 特性
|
||||
|
||||
- 基于 Nuxt 4 , Content v3 , Nuxt UI Pro 构建的文档系统。
|
||||
- 完美支持 Markdown 和 相关扩展。
|
||||
- 和 Vue 组件高度集成。
|
||||
- 支持搜索,由Content v3 赋能。
|
||||
- 支持多主题,使用Nuxt UI Pro。
|
||||
- 开源且免费。
|
||||
- 支持移动端。
|
||||
|
||||
## 致谢
|
||||
|
||||
- Nuxt Content:为 Vue 开发者简化内容管理。
|
||||
- Nuxt UI Pro :文档系统 UI 组件。
|
||||
- Docus:获取灵感及一些文档组件源代码。
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
3
content/blog/3.生活/.navigation.yml
Normal file
3
content/blog/3.生活/.navigation.yml
Normal file
@@ -0,0 +1,3 @@
|
||||
title: 生活
|
||||
description: 生活中一些有趣的事情
|
||||
icon: lucide-heart
|
238
content/blog/3.生活/01.index.md
Normal file
238
content/blog/3.生活/01.index.md
Normal file
@@ -0,0 +1,238 @@
|
||||
---
|
||||
title: 记录生活
|
||||
description: 记录生活点点滴滴
|
||||
date: 2025-08-07
|
||||
navigation:
|
||||
icon: lucide-house
|
||||
---
|
||||
|
||||
## 博客
|
||||
|
||||
使用过市面上的很多文档系统,但是或多或少都有一些自己不满意的功能.
|
||||
于是自己动手,丰衣足食.
|
||||
同时在 Markdown 语法的基础上增加了许多**魔法(自定义组件)**,比如:
|
||||
|
||||
|
||||
::code-group
|
||||
```mdc [index.md]
|
||||
在 Markdown 中使用::card 标签,即可创建一个卡片,卡片里可以放置任何内容。比如以下内容:
|
||||
::card
|
||||
这里是卡片里的内容
|
||||
::
|
||||
```
|
||||
|
||||
```html [Card.vue]
|
||||
<!-- Card组件: components/content/Card.vue -->
|
||||
<template>
|
||||
<div class="p-2 border bg-white dark:bg-black dark:border-gray-700 rounded">
|
||||
<slot />
|
||||
</div>
|
||||
</template>
|
||||
```
|
||||
:::code-preview{icon="i-lucide-eye" label="Preview"}
|
||||
::::example-card
|
||||
这里是卡片里的内容
|
||||
::::
|
||||
:::
|
||||
|
||||
::
|
||||
|
||||
:::UPageCard{icon="lucide-code" title="代码组" description="这个组件使用 自定义的 Markdown 语法,从 Markdown 中提取代码块,并展示在页面上 (而其自身亦是一个卡片组)"}
|
||||
|
||||
::code-tree{defaultValue="nuxt.config.ts"}
|
||||
|
||||
```css [app/assets/main.css]
|
||||
@import "tailwindcss" theme(static);
|
||||
@import "@nuxt/ui-pro";
|
||||
```
|
||||
|
||||
```ts [app/app.config.ts]
|
||||
export default defineAppConfig({
|
||||
ui: {
|
||||
colors: {
|
||||
primary: 'sky',
|
||||
colors: 'slate'
|
||||
}
|
||||
}
|
||||
});
|
||||
```
|
||||
|
||||
```vue [app/app.vue]
|
||||
<template>
|
||||
<UApp>
|
||||
<NuxtPage />
|
||||
</UApp>
|
||||
</template>
|
||||
```
|
||||
|
||||
```json [package.json]
|
||||
{
|
||||
"name": "nuxt-app",
|
||||
"private": true,
|
||||
"type": "module",
|
||||
"scripts": {
|
||||
"build": "nuxt build",
|
||||
"dev": "nuxt dev",
|
||||
"generate": "nuxt generate",
|
||||
"preview": "nuxt preview",
|
||||
"postinstall": "nuxt prepare",
|
||||
"typecheck": "nuxt typecheck"
|
||||
},
|
||||
"dependencies": {
|
||||
"@iconify-json/lucide": "^1.2.18",
|
||||
"@nuxt/ui-pro": "3.0.0-alpha.10",
|
||||
"nuxt": "^3.15.1"
|
||||
},
|
||||
"devDependencies": {
|
||||
"typescript": "^5.7.2",
|
||||
"vue-tsc": "^2.2.0"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```json [tsconfig.json]
|
||||
{
|
||||
"extends": "./.nuxt/tsconfig.json"
|
||||
}
|
||||
```
|
||||
|
||||
```ts [nuxt.config.ts]
|
||||
export default defineNuxtConfig({
|
||||
modules: ['@nuxt/ui-pro'],
|
||||
|
||||
future: {
|
||||
compatibilityVersion: 4
|
||||
},
|
||||
|
||||
css: ['~/assets/main.css']
|
||||
});
|
||||
```
|
||||
|
||||
````md [README.md]
|
||||
# Nuxt 3 Minimal Starter
|
||||
|
||||
Look at the [Nuxt 3 documentation](https://nuxt.com/docs/getting-started/introduction) to learn more.
|
||||
|
||||
## Setup
|
||||
|
||||
Make sure to install the dependencies:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm install
|
||||
|
||||
# pnpm
|
||||
pnpm install
|
||||
|
||||
# yarn
|
||||
yarn install
|
||||
|
||||
# bun
|
||||
bun install
|
||||
```
|
||||
|
||||
## Development Server
|
||||
|
||||
Start the development server on `http://localhost:3000`:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm run dev
|
||||
|
||||
# pnpm
|
||||
pnpm run dev
|
||||
|
||||
# yarn
|
||||
yarn dev
|
||||
|
||||
# bun
|
||||
bun run dev
|
||||
```
|
||||
|
||||
## Production
|
||||
|
||||
Build the application for production:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm run build
|
||||
|
||||
# pnpm
|
||||
pnpm run build
|
||||
|
||||
# yarn
|
||||
yarn build
|
||||
|
||||
# bun
|
||||
bun run build
|
||||
```
|
||||
|
||||
Locally preview production build:
|
||||
|
||||
```bash
|
||||
# npm
|
||||
npm run preview
|
||||
|
||||
# pnpm
|
||||
pnpm run preview
|
||||
|
||||
# yarn
|
||||
yarn preview
|
||||
|
||||
# bun
|
||||
bun run preview
|
||||
```
|
||||
|
||||
Check out the [deployment documentation](https://nuxt.com/docs/getting-started/deployment) for more information.
|
||||
````
|
||||
|
||||
::
|
||||
:::
|
||||
|
||||
::code-group
|
||||
```md [搜索.md]
|
||||
#### 此组件打开一个模态搜索框,进行搜索
|
||||
::::example-fulltext-content-search
|
||||
::::
|
||||
|
||||
#### 此组件建立一个mini搜索框,进行搜索
|
||||
::::example-fulltext-mini-search
|
||||
::::
|
||||
```
|
||||
|
||||
:::code-preview{label="预览模态组件" icon="i-lucide-eye"}
|
||||
::::example-fulltext-content-search
|
||||
::::
|
||||
:::
|
||||
:::code-preview{label="预览搜索框组件" icon="i-lucide-eye"}
|
||||
::::example-fulltext-mini-search
|
||||
::::
|
||||
:::
|
||||
|
||||
::
|
||||
|
||||
|
||||
::tip{icon="lucide-info" color="primary" class="text-black dark:text-white"}
|
||||
阅读更多关于 [`自定义组件`](/简单文档/components/api) 的内容.
|
||||
::
|
||||
|
||||
|
||||
## 特性
|
||||
|
||||
- 基于 Nuxt 4 , Content v3 , Nuxt UI Pro 构建的文档系统。
|
||||
- 完美支持 Markdown 和 相关扩展。
|
||||
- 和 Vue 组件高度集成。
|
||||
- 支持搜索,由Content v3 赋能。
|
||||
- 支持多主题,使用Nuxt UI Pro。
|
||||
- 开源且免费。
|
||||
- 支持移动端。
|
||||
|
||||
## 致谢
|
||||
|
||||
- Nuxt Content:为 Vue 开发者简化内容管理。
|
||||
- Nuxt UI Pro :文档系统 UI 组件。
|
||||
- Docus:获取灵感及一些文档组件源代码。
|
||||
|
||||
## License
|
||||
|
||||
MIT
|
@@ -21,6 +21,19 @@ export default defineNuxtConfig({
|
||||
markdown: {
|
||||
toc: {
|
||||
searchDepth: 1
|
||||
},
|
||||
highlight: {
|
||||
langs:
|
||||
['js', 'ts', 'jsx', 'tsx', 'js', 'json', 'bash', 'python', 'html', 'css', 'sql',
|
||||
'yaml', 'md', 'sh', 'go', 'java', 'c', 'cpp', 'php', 'ruby', 'swift', 'html'],
|
||||
theme: {
|
||||
// Default theme (same as single string)
|
||||
default: 'github-dark',
|
||||
// Theme used if `html.dark`
|
||||
dark: 'github-dark',
|
||||
// Theme used if `html.sepia`
|
||||
sepia: 'monokai'
|
||||
}
|
||||
}
|
||||
},
|
||||
pathMeta: {
|
||||
|
@@ -36,10 +36,10 @@
|
||||
"@iconify/utils": "^2.3.0",
|
||||
"@nuxt/content": "^3.6.3",
|
||||
"@nuxt/image": "^1.10.0",
|
||||
"@nuxt/ui-pro": "^3.2.0",
|
||||
"@nuxt/ui-pro": "^3.3.0",
|
||||
"better-sqlite3": "^12.2.0",
|
||||
"minisearch": "^7.1.2",
|
||||
"nuxt": "^4.0.1",
|
||||
"nuxt": "^4.0.3",
|
||||
"nuxt-llms": "0.1.3",
|
||||
"nuxt-og-image": "^5.1.9"
|
||||
},
|
||||
|
1164
pnpm-lock.yaml
generated
1164
pnpm-lock.yaml
generated
File diff suppressed because it is too large
Load Diff
BIN
public/images/default-blog.jpg
Normal file
BIN
public/images/default-blog.jpg
Normal file
Binary file not shown.
After Width: | Height: | Size: 140 KiB |
228
项目说明/简介文档.md
Normal file
228
项目说明/简介文档.md
Normal file
@@ -0,0 +1,228 @@
|
||||
# Estel Docs 文档系统 - 项目简介
|
||||
|
||||
## 📋 项目概述
|
||||
|
||||
**Estel Docs** 是一个基于 Nuxt 4 构建的现代化文档系统,采用简约设计但功能强大。系统支持文档管理和博客发布,提供完整的 Markdown 内容管理解决方案。
|
||||
|
||||
## 🏗️ 技术架构
|
||||
|
||||
### 核心技术栈
|
||||
- **框架**: Nuxt 4 (Vue 3 + Vite)
|
||||
- **UI 组件库**: Nuxt UI Pro
|
||||
- **内容管理**: Nuxt Content 3
|
||||
- **图片优化**: Nuxt Image
|
||||
- **图标系统**: Lucide + Iconify
|
||||
- **类型安全**: TypeScript
|
||||
- **包管理**: pnpm
|
||||
- **代码规范**: ESLint
|
||||
|
||||
### 主要模块
|
||||
```typescript
|
||||
modules: [
|
||||
'@nuxt/eslint', // 代码规范
|
||||
'@nuxt/image', // 图片优化
|
||||
'@nuxt/ui-pro', // UI 组件库
|
||||
'@nuxt/content', // 内容管理
|
||||
'nuxt-og-image', // Open Graph 图片生成
|
||||
'@nuxt/fonts', // 字体优化
|
||||
'nuxt-llms' // AI 集成
|
||||
]
|
||||
```
|
||||
|
||||
## 📁 项目结构
|
||||
|
||||
```
|
||||
项目根目录/
|
||||
├── app/ # 应用核心代码
|
||||
│ ├── components/ # Vue 组件
|
||||
│ │ ├── blog/ # 博客相关组件
|
||||
│ │ ├── docs/ # 文档相关组件
|
||||
│ │ └── shared/ # 共享组件
|
||||
│ ├── layouts/ # 布局组件
|
||||
│ │ ├── blog.vue # 博客布局
|
||||
│ │ └── docs.vue # 文档布局
|
||||
│ ├── pages/ # 页面路由
|
||||
│ └── composables/ # 组合式函数
|
||||
├── content/ # 内容目录
|
||||
│ ├── docs/ # 文档内容
|
||||
│ │ ├── 1.简单文档/
|
||||
│ │ └── 2.无人自助系统/
|
||||
│ └── blog/ # 博客内容
|
||||
│ ├── 1.技术栈/
|
||||
│ ├── 2.AI/
|
||||
│ └── 3.生活/
|
||||
├── public/ # 静态资源
|
||||
└── nuxt.config.ts # Nuxt 配置
|
||||
```
|
||||
|
||||
## 🎯 核心功能
|
||||
|
||||
### 1. 文档系统 (Docs)
|
||||
- **Markdown 支持**: 完整的 Markdown 语法支持
|
||||
- **目录导航**: 自动生成文档目录结构
|
||||
- **搜索功能**: 全文搜索和导航搜索
|
||||
- **代码高亮**: 语法高亮和代码块
|
||||
- **响应式设计**: 适配各种设备屏幕
|
||||
- **深色模式**: 支持明暗主题切换
|
||||
|
||||
### 2. 博客系统 (Blog)
|
||||
- **文章列表**: 响应式卡片布局展示
|
||||
- **图片预览**: 支持文章封面图片
|
||||
- **分类管理**: 按技术栈、AI、生活等分类
|
||||
- **时间显示**: 文章发布时间展示
|
||||
- **原始内容查看**: 支持查看 Markdown 原始内容
|
||||
|
||||
### 3. 内容管理
|
||||
- **双集合架构**: docs 和 blog 两个独立内容集合
|
||||
- **Schema 验证**: 使用 Zod 进行内容结构验证
|
||||
- **导航配置**: 支持 .navigation.yml 文件配置
|
||||
- **SEO 优化**: 自动生成 Open Graph 图片
|
||||
|
||||
## 🎨 前端样式与呈现
|
||||
|
||||
### 设计理念
|
||||
- **简约现代**: 采用简洁的设计语言
|
||||
- **响应式优先**: 移动端优先的响应式设计
|
||||
- **可访问性**: 遵循 WCAG 可访问性标准
|
||||
- **性能优化**: 图片懒加载、代码分割等
|
||||
|
||||
### 主要样式特点
|
||||
1. **卡片式布局**: 博客文章采用卡片式展示
|
||||
2. **渐变效果**: Hero 区域使用渐变背景
|
||||
3. **悬停动画**: 丰富的交互动画效果
|
||||
4. **圆角设计**: 统一的圆角设计语言
|
||||
5. **阴影层次**: 合理的阴影层次营造深度感
|
||||
|
||||
### 组件系统
|
||||
- **BlogHero**: 博客首页 Hero 区域
|
||||
- **BlogHeader**: 博客页面头部导航
|
||||
- **IndexBlog**: 博客文章列表组件
|
||||
- **AppSidebar**: 侧边栏导航组件
|
||||
- **AppHeader**: 顶部导航组件
|
||||
|
||||
## 🔧 实现方式
|
||||
|
||||
### 1. 内容管理实现
|
||||
```typescript
|
||||
// content.config.ts
|
||||
collections: {
|
||||
docs: defineCollection({
|
||||
type: 'page',
|
||||
source: { include: 'docs/**' },
|
||||
schema: z.object({
|
||||
rawbody: z.string(),
|
||||
links: z.array(z.object({
|
||||
label: z.string(),
|
||||
icon: z.string(),
|
||||
to: z.string()
|
||||
})).optional()
|
||||
})
|
||||
}),
|
||||
blog: defineCollection({
|
||||
type: 'page',
|
||||
source: { include: 'blog/**' },
|
||||
schema: z.object({
|
||||
rawbody: z.string(),
|
||||
img: z.string(),
|
||||
date: z.string()
|
||||
})
|
||||
})
|
||||
}
|
||||
```
|
||||
|
||||
### 2. 路由系统
|
||||
- **动态路由**: `[...slug].vue` 处理所有内容页面
|
||||
- **布局切换**: 根据路径自动选择 docs 或 blog 布局
|
||||
- **原始内容**: `/raw/[...slug]` 查看 Markdown 原始内容
|
||||
|
||||
### 3. 数据查询
|
||||
```typescript
|
||||
// 查询文档内容
|
||||
const { data: page } = await useAsyncData(
|
||||
`page-${route.path}`,
|
||||
() => queryCollection('docs').path(queryPath.value).first()
|
||||
)
|
||||
|
||||
// 查询博客文章
|
||||
const { data: articles } = await useAsyncData(
|
||||
'blog-articles',
|
||||
() => queryCollection('blog')
|
||||
.select('path', 'title', 'description', 'img', 'date')
|
||||
.where('path', 'NOT LIKE', '%navigation%')
|
||||
.all()
|
||||
)
|
||||
```
|
||||
|
||||
## ⚠️ 注意事项
|
||||
|
||||
### 1. 开发环境
|
||||
- **Node.js 版本**: 建议使用 Node.js 18+
|
||||
- **包管理器**: 使用 pnpm 作为包管理器
|
||||
- **TypeScript**: 严格模式,注意类型安全
|
||||
|
||||
### 2. 内容管理
|
||||
- **文件命名**: 使用数字前缀确保排序 (如: `1.技术栈/`)
|
||||
- **导航配置**: 在目录下创建 `.navigation.yml` 配置导航
|
||||
- **图片路径**: 使用相对路径或外部 CDN 链接
|
||||
|
||||
### 3. 部署相关
|
||||
- **静态生成**: 支持静态站点生成 (SSG)
|
||||
- **服务端渲染**: 支持服务端渲染 (SSR)
|
||||
- **环境变量**: 注意配置必要的环境变量
|
||||
|
||||
### 4. 性能优化
|
||||
- **图片优化**: 使用 Nuxt Image 进行图片优化
|
||||
- **代码分割**: 自动代码分割和懒加载
|
||||
- **缓存策略**: 合理配置缓存策略
|
||||
|
||||
## 🚀 还需要什么
|
||||
|
||||
### 1. 功能增强
|
||||
- [ ] **评论系统**: 集成评论功能
|
||||
- [ ] **用户认证**: 添加用户登录注册
|
||||
- [ ] **内容编辑**: 在线 Markdown 编辑器
|
||||
- [ ] **版本控制**: 内容版本管理
|
||||
- [ ] **多语言**: 国际化支持
|
||||
|
||||
### 2. 性能优化
|
||||
- [ ] **CDN 配置**: 配置 CDN 加速
|
||||
- [ ] **缓存策略**: 优化缓存配置
|
||||
- [ ] **图片压缩**: 自动图片压缩
|
||||
- [ ] **代码分割**: 进一步优化代码分割
|
||||
|
||||
### 3. 开发工具
|
||||
- [ ] **自动化测试**: 添加单元测试和集成测试
|
||||
- [ ] **CI/CD**: 配置自动化部署流程
|
||||
- [ ] **监控系统**: 添加性能监控
|
||||
- [ ] **错误追踪**: 集成错误追踪系统
|
||||
|
||||
### 4. 内容管理
|
||||
- [ ] **内容备份**: 自动内容备份策略
|
||||
- [ ] **SEO 优化**: 进一步优化 SEO
|
||||
- [ ] **搜索增强**: 改进搜索功能
|
||||
- [ ] **内容导入**: 支持批量内容导入
|
||||
|
||||
### 5. 用户体验
|
||||
- [ ] **PWA 支持**: 添加 PWA 功能
|
||||
- [ ] **离线支持**: 离线内容访问
|
||||
- [ ] **阅读模式**: 专注阅读模式
|
||||
- [ ] **分享功能**: 社交媒体分享
|
||||
|
||||
## 📊 技术指标
|
||||
|
||||
- **构建时间**: < 30s
|
||||
- **首屏加载**: < 2s
|
||||
- **Lighthouse 评分**: > 90
|
||||
- **SEO 评分**: > 95
|
||||
- **可访问性**: > 90
|
||||
|
||||
## 🔗 相关链接
|
||||
|
||||
- **项目仓库**: https://github.com/estel-li/estel-docs
|
||||
- **在线演示**: https://docs.jiwei.xin
|
||||
- **个人博客**: https://lijue.me
|
||||
- **技术文档**: https://nuxt.com/docs
|
||||
|
||||
---
|
||||
|
||||
*最后更新: 2024年12月*
|
Reference in New Issue
Block a user