Nextjs 是什么
NextJs 是一个基于 React 的开源框架，用于构建生产级别的 React 应用程序。它为开发人员提供了一套丰富的工具和约定，使得创建高性能、可扩展的 Web 应用程序变得更加容易。
相关代码Blog
Next.js 的主要特性：
服务器端渲染 (SSR)：
1- 提高首屏加载速度，改善用户体验。
2- 有利于 SEO，搜索引擎可以更好地抓取页面内容。
静态站点生成 (SSG)：
1- 将整个应用程序或部分页面预渲染成静态 HTML 文件。
2- 适用于数据变化不频繁的网站，提供极快的加载速度。
API 路由：
1- 内置 API 路由功能，可以轻松创建 RESTful API 或 GraphQL API。
文件系统路由：
1- 根据文件系统结构自动生成路由，简化路由配置。
图像优化：
1- 内置图像优化功能，自动优化图片大小和格式，提升页面加载速度。
TypeScript 支持：
1- 原生支持 TypeScript，提供静态类型检查，提高代码质量。
自定义服务器：
1- 可以自定义服务器，满足各种复杂场景的需求。
插件系统：
1- 丰富的插件生态系统，可以扩展 Next.js 的功能。
安装
使用官网推荐的方式安装，执行 npx create-next-app@latest，输入项目名称，选择相关options选项就可以完成项目的初始化。如下 
可以看到，我们可以选择是否使用 ts, eslint, tailwindcss等等。
锁定引擎
在 package.json中添加 "engines": { "node": ">=18.0.0", "pnpm": ">=9.0.0" } 这样可以限制启动的 node版本和 pnpm版本，防止出现兼容性问题。
启动
pnpm dev，看到这个界面就是启动成功了
路由
创建路由
nextjs中的路由采用的是 约定式路由，根据文件的配置自动生成，我们可以看一下默认生成的文件结构。
.next目录是运行的文件，app是路由的目录，public可以用于存放一些静态资源。
所有的路由文件都放在 app中，page就是内容页，layout就是布局页面的模板，error是错误页面，loading是加载页面，not-found是404页面。比如我们需要创建一个 dashborad页面，只需要在 app下新增一个 dashboard/page.tsx即可。
带params的路由格式是 [id].tsx，如下。
app/layout： 等于react中的main.ts，app.ts，以及Vue中的App.vue，全局的布局，可以用来加载全局的样式，字体，metadata等等。
1import type { Metadata } from "next";
2import { Inter } from "next/font/google";
3import "./globals.css";
4
5const inter = Inter({ subsets: ["latin"] });
6
7export const metadata: Metadata = {
8 title: "Create Next App",
9 description: "Generated by create next app",
10};
11
12export default function RootLayout({
13 children,
14}: Readonly<{
15 children: React.ReactNode;
16}>) {
17 return (
18 <html lang="en">
19 <body className={inter.className}>
20 <header className="h-12 border-b">头部</header>
21 <main>{children}</main>
22 </body>
23 </html>
24 );
25}
[folder]/layout： 单个菜单下的布局，类似vue/react中的二级路由
page：页面内容
路由跳转
这里有四种方式来实现路由的跳转。
-
使用
next/link内置组件1import Link from 'next/link' 2 3<Link href='/dashborad'></Link> -
使用
useRouter钩子函数，适用于client
1import { useRouter } from 'next/navigation'
2export default function Page() {
3 const router = useRouter()
4 return (
5 <button type="button" onClick={() => router.push('/dashboard')}>
6 Dashboard
7 </button>
8 )
9}
-
对于
server component1 import { redirect } from 'next/navigation' 2 3 async function fetchTeam(id: string) { 4 const res = await fetch('https://...') 5 if (!res.ok) return undefined 6 return res.json() 7 } 8 9 export default async function Profile({ params }: { params: { id: string } }) { 10 const team = await fetchTeam(params.id) 11 if (!team) { 12 redirect('/login') 13 } 14 15 } -
使用原生
history1 'use client' 2 3 import { useSearchParams } from 'next/navigation' 4 5 export default function SortProducts() { 6 const searchParams = useSearchParams() 7 8 function updateSorting(sortOrder: string) { 9 const params = new URLSearchParams(searchParams.toString()) 10 params.set('sort', sortOrder) 11 window.history.pushState(null, '', `?${params.toString()}`) 12 } 13 14 return ( 15 <> 16 <button onClick={() => updateSorting('asc')}>Sort Ascending</button> 17 <button onClick={() => updateSorting('desc')}>Sort Descending</button> 18 </> 19 ) 20 }
路由参数传递和获取
对于服务端组件来说，主函数的参数中自动注入，params和 searchParams，例如我们访问这个链接的时候 http://localhost:3001/dashboard/1?a=1
此时在主函数的 datas, 他的内容就是 { params: { id: '1' }, searchParams: { a: '1' } }
1
2export default async function DashboardPage(datas: any) {
3 const data = await getData();
4 return (
5 <div className="h-[100vh]">
6 <div>
7 这是仪表盘页面 {datas.params.id} {JSON.stringify(data)}{" "}
8 </div>
9 </div>
10 );
11}
对于客户端组件来说，也可以用上面的方式来获取，初次除此以外还可以通过 useParams和 useSearchParams来获取。
1import { useParams, useSearchParams } from "next/navigation";
2
3
4export default function DashboardPage() {
5 const params = useParams();
6 const searchParams = useSearchParams();
7 return (
8 <div className="h-[100vh]">
9 <div>这是仪表盘页面 {params.id}</div>
10 </div>
11 );
12}
API路由
由于nextjs是运行在服务端的，所以他也能实现后端的服务，实现的方式是在 app下创建一个 api目录。在 api目录下插入一个 dashboard/metrics目录，然后创建一个 route.ts，这样子就实现了一个api路由了。请求路径是 /dashboard/metrics，方法为 get的请求。
1import { responseHandler } from "@/lib/fetch";
2
3export async function GET(request: Request) {
4 return responseHandler({
5 rate: '100%',
6 rate2: '100%',
7 rate3: '100%'
8 });
9}
10
文件约定
error.js：当页面UI加载错误的时候会显示此页面；
not-found.js: 当页面不存在的时候显示此页面； 例如当我们访问这个链接 http://localhost:3001/xx，此时就会渲染此页面。
loading.js: 当组件加载的时候就会触发这个动画，使用Suspense实现
middleware.js: 中间件，常用于来做鉴权，拦截， 重写和重定向，自定义头部，缓存等等。
1
2
3 export async function middleware(req) {
4 const token = req.cookies.token;
5 if (!token) {
6 return NextResponse.redirect(new URL('/login', req.url));
7 }
8 return NextResponse.next();
9 }
10
11
12 export const config = { matcher: ['/protected/:path*'] };
除 middleware外，其他都支持全局和局部。
数据请求
-
在服务端组件中，使用
fetch请求，而且自带缓存，Post请求不缓存，通过在fetch中的配置，默认是{ cache: 'force-cache' }。如果需要重新验证数据的一致性，可以设置
{ next: { revalidate: 3600 } }，这样每小时会重新验证一次，或者在page/layout.ts设置export const revalidate = 3600
1 export const revalidate = 3600
2
3 async function getData() {
4 const res = await fetch('http://localhost:3000/api/dashboard/metric')
5
6 if (!res.ok) {
7 throw new Error('Failed to fetch data')
8 }
9
10 return res.json()
11 }
12
13 export default async function Page() {
14 const data = await getData()
15
16 return <main>
17 指标是: {{ JSON.stringify(data.data) }}
18 </main>
19 }
也可以不缓存，通过设置 { cache: 'no-store' }，也可以按需重新验证，参考此文档on-demand-revalidation，也可以在文件头部 export const dynamic = 'force-dynamic';这样每次都会新的。
- Server Actions and Mutations
渲染
服务端组件
在app下的
服务端组件渲染有三种方式。
-
Static Rendering(静态渲染)
这是默认的渲染方式，在build的时候就会完成数据的请求和页面组装，比如一个项目的首页
-
Dynamic Rendering(动态渲染)
在用户请求的时候渲染完成，比如一个订单的详情页，根据不同的ID来渲染不同的数据
-
Streaming(流式渲染)
简单来说就是将一整个 HTML 脚本文件通过切成一小段一小段的方式返回给客户端，客户端收到每一段内容时进行分批渲染。这样的方式相较于传统的服务端一次性渲染完成整个 HTML 内容进行返回，在视觉上大大减少了 TTFB 以及 FP 的时间，在用户体验上更好。主要原理是基于
Suspense/Lazy进行异步渲染组件，这样我们可以把一些不变的静态数据和动态数据拆分成多个组件，父组件中用Suspense包裹，然静态数据先渲染，从而提高TTFB（time to first byte）和FP（first paint）指标。
1
2function getDate(): Promise<string> {
3 return new Promise((resolve) =>
4 setTimeout(() => {
5 resolve("This is Great.");
6 }, 3000)
7 );
8}
9
10export default async function Metric1() {
11 const data: string = await getDate();
12
13 return (
14 <>
15 <div>{data}</div>
16 </>
17 );
18}
19
1
2function getDate(): Promise<string> {
3 return new Promise((resolve) =>
4 setTimeout(() => {
5 resolve("This is Great.");
6 }, 3000)
7 );
8}
9
10export default async function Metric1() {
11 const data: string = await getDate();
12
13 return (
14 <>
15 <div>{data}</div>
16 </>
17 );
18}
19
1import Metric1 from "@/components/metric1";
2import Metric2 from "@/components/metric2";
3import { Suspense } from "react";
4
5async function getData() {
6 const res = await fetch("http://localhost:3001/api/dashboard/metric/");
7
8
9
10 if (!res.ok) {
11
12 throw new Error("Failed to fetch data");
13 }
14
15 return res.json();
16}
17
18export default async function DashboardPage(datas: any) {
19 const data = await getData();
20 return (
21 <div className="h-[100vh]">
22 <div>
23 这是仪表盘页面 {datas.params.id} {JSON.stringify(data)}{" "}
24 </div>
25
26 <Suspense fallback={<div>Loading metric1...</div>}>
27 <Metric1 />
28 </Suspense>
29
30 <Suspense fallback={<div>Loading metric2...</div>}>
31 <Metric2 />
32 </Suspense>
33 </div>
34 );
35}
36
这时候我们就可以看到主体内容先渲染了，metric1，和metric2在loading，等待数据获得后再渲染。 
优势
在服务器上执行渲染工作有几个好处，包括：
数据提取：服务器组件允许您将数据提取移动到更接近数据源的服务器。这可以通过减少获取渲染所需数据所需的时间以及客户端需要发出的请求数量来提高性能。
安全：服务器组件允许您将敏感数据和逻辑保留在服务器上，例如令牌和API密钥，而不会面临将它们暴露给客户端的风险。
缓存：通过在服务器上呈现，结果可以被缓存并在后续请求和跨用户中重复使用。这可以通过减少每次请求上完成的渲染和数据获取量来提高性能并降低成本。
性能：服务器组件为您提供了额外的工具来从基线优化性能。例如，如果您从完全由客户端组件组成的应用程序开始，则将UI的非交互式部分移动到服务器组件可以减少所需的客户端JavaScript量。这对于互联网速度较慢或设备功能较弱的用户来说是有利的，因为浏览器需要下载、解析和执行的客户端JavaScript较少。
初始页面加载和第一个内容绘制（FCP）：在服务器上，我们可以生成HTML以允许用户立即查看页面，而无需等待客户端下载、解析和执行渲染页面所需的JavaScript。
搜索引擎优化和社交网络共享性：搜索引擎机器人可以使用渲染的HTML来索引页面，社交网络机器人可以使用渲染的HTML为您的页面生成社交卡预览。
流媒体：服务器组件允许您将渲染工作拆分为块，并在准备好后将其流媒体传输给客户端。这允许用户更早地查看页面的部分内容，而不必等待整个页面在服务器上呈现。
客户端组件（Client Components）
使用客户端组件的方式也很简单，首行写 use client即开启
1'use client'
2
3import { useState } from 'react'
4
5export default function Counter() {
6 const [count, setCount] = useState(0)
7
8 return (
9 <div>
10 <p>You clicked {count} times</p>
11 <button onClick={() => setCount(count + 1)}>Click me</button>
12 </div>
13 )
14}
客户端组件并非仅仅在客户端渲染，也可以在服务端渲染，这取决于是否是全页面加载（Full page load），还是页面中导航过去的(Subsequent Navigations)。
如果是全页加载的，即首次加载或刷新，这时候也是通过服务端渲染的而导航过去的，这时候是客户端渲染的。
优势
- 可以使用相关的API和交互
useEffect，state，event listener等 - 可以使用浏览器API
样式
样式在初始化项目的时候安装了tailwindcss，可以看文档。
优化
字体
nextjs中使用next/font来加载谷歌字体，而不是在css到声明字体，因为它帮我们优化了字体的加载，很方便使用各种各样的字体。官方推荐使用可变字体，这里是字体库
如下，我们可以看到引入了两种字体，字体中可以设置 子集，样式等options.
1import Link from "next/link";
2import { Inter, Roboto_Mono } from "next/font/google";
3
4
5const inter = Inter({
6 subsets: ["latin"],
7 display: "swap",
8});
9
10export const roboto_mono = Roboto_Mono({
11 subsets: ["latin"],
12 weight: ["700"],
13 display: "swap",
14 variable: "--Roboto_Mono",
15});
16export default function Home() {
17 return (
18 <main
19 className={`flex min-h-screen flex-col items-center justify-between p-24 ${inter.className}`}
20 >
21 <header>这是头部</header>
22 <div>这是一种字体</div>
23 <div className={roboto_mono.className}>这是另一种字体</div>
24 <div>
25 <Link href={"/dashboard"}>dashboard</Link>
26 </div>
27
28 <div>这是footer</div>
29 </main>
30 );
31}
32
同时也可以加载本地字体。
1import localFont from 'next/font/local'
2const myFont = localFont({ src: './my-font.woff2', display: 'swap',})
display就是“font-display”专用于 @font-face 指令的描述符，它可以取如下几个值：
- auto 。这个是 font-display 的默认值，字体的加载过程由浏览器自行决定，不过基本上和取值为 block 时的处理方式一致。
- block 。在字体加载前，会使用备用字体渲染，但是显示为空白，使得它一直处于阻塞期，当字体加载完成之后，进入交换期，用下载下来的字体进行文本渲染。不过有些浏览器并不会无限的处于阻塞期，会有超时限制，一般在 3 秒后，如果阻塞期仍然没有加载完字体，那么直接就进入交换期，显示后备字体（而非空白），等字体下载完成之后直接替换。
- swap 。基本上没有阻塞期，直接进入交换期，使用后备字体渲染文本，等用到的字体加载完成之后替换掉后备字体。
- fallback 。阻塞期很短（大约100毫秒），也就是说会有大约 100 毫秒的显示空白的后备字体，然后交换期也有时限（大约 3 秒），在这段时间内如果字体加载成功了就会替换成该字体，如果没有加载成功那么后续会一直使用后备字体渲染文本。
- optional 。与 fallback 的阻塞期一致，但是没有交换期，如果在阻塞期的 100 毫秒内字体加载完成，那么会使用该字体，否则直接使用后备字体。这个就是说指定的网络字体是可有可无的，如果加载很快那么可以显示，加载稍微慢一点就不会显示了，适合网络情况不好的时候，例如移动网络。
图片
优点
Image组件，Image是在img得基础上的封装，主要增强了以下功能。
大小优化：使用 WebP 和 AVIF 等现代图像格式，自动为每台设备提供正确大小的图像。
视觉稳定：防止偏移，有效优化Cumulative Layout Shift (CLS)累计布局偏移量。
更快的加载速度：进入视口后在进行加载，更快的页面加载速度。
自适应：可以设置优先级，压缩质量，包括宽高，即使图片是在服务器上。
1
2<Image
3 src={detail.coverImg}
4 width={0}
5 height={0}
6 sizes="100%"
7 style={{ width: "100%", height: "auto" }}
8 priority={true}
9 alt="cover_img"
10 />
安全
可以设置指定域名的远程图片，在 next.config.mjs
1 images: {
2 remotePatterns: [
3 {
4 protocol: "https",
5 hostname: "avatars.githubusercontent.com",
6 },
7 {
8 protocol: "https",
9 hostname: "**.myqcloud.com",
10 },
11 {
12 protocol: "https",
13 hostname: "**.xitu.io",
14 },
15 {
16 protocol: "https",
17 hostname: "**.byteimg.com",
18 },
19 ],
20 },
主题的实现
通用的主题的实现有以下几种方式。
- 使用CSS变量来实现
- 使用CSS-in-JS实现主题切换
- 引入不同的CSS文件来实现主题的切换
- 使用CSS预处理器来实现主题
具体实现可以参考这篇文章如何实现前端页面主题切换：多种方法详解
我们这里使用css变量的方式结合next-themes来实现，暗黑，明亮，跟随系统三种主题。
安装
1pnpm add next-themes
增加主题变量
然后修改 global.css
1@tailwind base;
2@tailwind components;
3@tailwind utilities;
4
5:root {
6
7 --background-color: #111827;
8
9 --text-color: white;
10}
11
12body {
13 background-color: var(--background-color);
14 color: var(--text-color);
15 line-height: 1.5;
16 font-size: 14px;
17}
18
19// 明亮主题
20.light {
21 --background-color: #fff;
22 --text-color: #111827;
23}
24// 暗黑主题
25.dark {
26 --background-color: #111827;
27 --text-color: #fff;
28}
29
30// 系统自适应暗黑
31@media (prefers-color-scheme: dark) {
32 :root:not(.dark):not(.light) {
33 --background-color: #111827;
34 --text-color: #fff;
35 }
36
37}
38
39// 系统自适应明亮
40@media (prefers-color-scheme: light) {
41 :root:not(.dark):not(.light) {
42 --background-color: #fff;
43 --text-color: #111827;
44 }
45
46}
实现ThemeProvider
然后在 provider目录创建 ThemeProvider.
1"use client";
2
3import { ThemeProvider as NextThemesProvider } from "next-themes";
4import type { ThemeProviderProps } from "next-themes/dist/types";
5
6export default function ThemeProvider({
7 children,
8 ...props
9}: ThemeProviderProps) {
10 return <NextThemesProvider {...props}>{children}</NextThemesProvider>;
11}
12
最后在 app/layout.txs中使用，设置 attribute用class，默认主题用暗黑模式，支持跟随系统，mac支持，windows不支持。
1 <ThemeProvider attribute="class" defaultTheme="dark" enableSystem>
2 <header className="h-12 border-b">头部</header>
3 <main>{children}</main>
4</ThemeProvider>
5
主题切换组件
然后就可以创建一个切换主题的组件，通过 setTheme来实现主题的设置。
1"use client";
2import { useTheme } from "next-themes";
3
4const ThemeChanger = () => {
5 const { theme, setTheme } = useTheme();
6
7 return (
8 <div>
9 <div>
10 现在主题是: <span>{theme}</span>
11 </div>
12 <button onClick={() => setTheme("light")}>明亮</button>
13 {" "}
14 <button onClick={() => setTheme("dark")}>暗黑模式</button>
15 {" "}
16
17 <button onClick={() => setTheme("os")}>跟随系统</button>
18 </div>
19 );
20};
21
22export default ThemeChanger;
23
到此，我们即完成了切换主题。
滚动优化
此处我们我使用了 lenis来实现滚动的优化，代替默认的滚动。
安装
1pnpm add lenis
新建Provider
创建 provider/leniProvider.tsx
1"use client";
2import { ReactLenis } from "lenis/react";
3import { ReactNode } from "react";
4
5interface Props {
6 children: ReactNode;
7}
8
9export default function LenisProvider({ children }: Props) {
10 return <ReactLenis root>{children}</ReactLenis>;
11}
12
创建 provider/scrollProvider.tsx
1"use client";
2
3import { useLenis } from "lenis/react";
4import { createContext, ReactNode, useState } from "react";
5
6interface ScrollValue {
7 scrollY: number;
8}
9
10export const ScrollContext = createContext<ScrollValue>({
11 scrollY: 0,
12});
13
14interface ScrollProviderProps {
15 children: ReactNode;
16}
17
18export const ScrollProvider = ({ children }: ScrollProviderProps) => {
19 const [scrollY, setScrollY] = useState(0);
20
21 const [mounted, setMounted] = useState(false);
22
23 useLenis(({ scroll }: any) => {
24 setMounted(true);
25 setScrollY(scroll);
26 });
27 if (!mounted) return null;
28
29 return (
30 <ScrollContext.Provider value={{ scrollY }}>
31 {children}
32 </ScrollContext.Provider>
33 );
34};
35
使用
在 app/layout.tsx中使用。
1import type { Metadata } from "next";
2import { Inter } from "next/font/google";
3import "./globals.css";
4import ThemeProvider from "@/provider/themeprovider";
5import dynamic from "next/dynamic";
6import LenisProvider from "@/provider/LenisProvider";
7import { ScrollProvider } from "@/provider/scrollProvider";
8
9const inter = Inter({ subsets: ["latin"] });
10
11export const metadata: Metadata = {
12 title: "Create Next App",
13 description: "Generated by create next app",
14};
15
16const ThemeChanger = dynamic(() => import("@/components/theme"), {
17 ssr: false,
18});
19
20export default function RootLayout({
21 children,
22}: Readonly<{
23 children: React.ReactNode;
24}>) {
25 return (
26 <html lang="en" suppressHydrationWarning>
27 <body className={inter.className}>
28 <ThemeProvider attribute="class" defaultTheme="dark" enableSystem>
29 <LenisProvider>
30 <ScrollProvider>
31 <header className="h-12 border-b">头部</header>
32 <ThemeChanger />
33
34 <main>{children}</main>
35 </ScrollProvider>
36 <div id="modal"></div>
37 </LenisProvider>
38 </ThemeProvider>
39 </body>
40 </html>
41 );
42}
43
44
此时我们可以通过 Scrollprivider来访问 scrollY，以及progress等等
在 dashboard/page.tsx中我们使用context来inject进来scrollY。
1"use client";
2
3import { ScrollContext } from "@/provider/scrollProvider";
4import Link from "next/link";
5import { useContext } from "react";
6
7export default function DashboardPage({
8 children,
9}: {
10 children: React.ReactNode;
11}) {
12 const { scrollY } = useContext(ScrollContext);
13 return (
14 <div className="h-[100vh]">
15 <div>
16 <Link href={"/dashboard/1"}>我们去仪表盘1{scrollY}</Link>
17
18 <div>scrollY: {scrollY}</div>
19 </div>
20 <div>{children}</div>
21 </div>
22 );
23}
24
数据库/Docker安装
我所使用的是腾讯云的服务器，系统为 OpenCloudOS Docker版本，所以不需要安装，只需要安装 mongodb即可。
Docker命令
这里说明一下docker的常用命令。
systemctl start docker启动systemctl stop docker启动systemctl enable docker开机启动docker search mongodb查询镜像docker pull mongodb拉取镜像docker run -d --name=xxx xxx mongodb:latest基于某镜像创建一个容器docker ps查看运行中的容器docker stop container_id/name停止运行中的容器docker start container_id/name启动运行中的容器 这些是常用的命令。
MongoDb
所以此处我们需要安装mongodb的话，就需要执行命令。
docker pull mongo
在启动之前，我们需要把数据挂载到本地服务器，这样容器重启数据也不会丢失，还有数据的备份，日志，配置等等。
1// 数据保存到/data/mdb文件夹中
2mkdir -p /data/mdb
3
4// 数据备份
5mkdir -p /data/backup/mongodb
6
7// 日志
8mkdir -p /data/mdblog
9
10// 配置
11mkdir -p /data/mongo_conf
其它的东西不用动，我这边加了一个配置，需要设置一个bindIP和auth来设置需要密码和指定IP可访问，否则会被黑客勒索。
1
2storage:
3 dbPath: /data/mdb
4 journal:
5 enabled: true
6systemLog:
7 destination: file
8 logAppend: true
9 path: /data/mdblog/mongod.log
10
11
12net:
13 port: 3009
14 bindIp: 127.0.0.1,150.109.25.213
15
16
17
18auth:true
19
现在我们就可以启动moogodb了。
1docker run --name mongo --restart=always -p 3009:27017 -v /data/mdb:/data/db -v /data/backup/mongodb:/data/backup -v /data/mdblog:/data/log -v /data/mongo_conf:/data/conf -d mongo
// -v映射目录
// —name名称
// 3009:27017端口映射服务器的3009端口映射到容器的的27017端口
这时候我们看到了已经启动成功了。
创建管理员账户
进入容器。
1docker exec -it mongo mongosh
显示这样基本上就表示登录成功。
查看数据库。
1show dbs;
这是可以看到现有的db
然后进入admin use admin.
创建管理员账户。
1admin> db.createUser({ user: 'admin', pwd: 'admin', roles: [ { role: "userAdminAnyDatabase", db: "admin" } ] });
2{ ok: 1 }
3admin> db.auth('admin', 'admin')
4{ ok: 1 }
这样就表示创建成功且auth通过，这时候就可以测试连接了。mongodb://admin:admin@host:port/admin?authMechanism=DEFAULT
创建DB
这里我们创建一个 blog的db.
1 use blog // 没有会自动创建
2
3 db.createCollection('articles') // 创建一个集合
4
5 db.articles.insertOne({title: 'xxx'}) // 插入数据
可以看到数据已经插入了。
mongoose
Mongoose 提供了一种直接的、基于架构的解决方案来为您的应用程序数据建模。它包括内置的类型转换、验证、查询构建、业务逻辑挂钩等，开箱即用。
安装
1pnpm add mongoose --save
创建一个工具函数 lib/mongoose.ts
1import mongoose from "mongoose";
2
3const connectMongo = async () =>
4 await mongoose.connect(process.env.MONGO_URI as string, {
5 autoCreate: true,
6 });
7
8export default connectMongo;
9
数据模型
我们先增加一个 USER，相关规则可以查看此处schematypes
首先定义一个user的 DTO和 VO在 types/user.ts
1export interface USER_DTO {
2 name: string;
3 image: string;
4 email: string;
5 password: string;
6 created_at?: Date;
7 updated_at?: Date;
8}
9
10export interface USER_VO {
11 name: string;
12 image: string;
13 email: string;
14 created_at: Date;
15 updated_at: Date;
16}
17
1import { Schema, model, models } from "mongoose";
2import { USER_DTO } from '@/types/user
3
4const userSchema = new Schema<USER_DTO>({
5 name: {
6 type: String,
7 required: true,
8 trim: true,
9 max_length: 50,
10 },
11 image: {
12 type: String,
13 required: true,
14 default: "https://blog-1302483222.cos.ap-shanghai.myqcloud.com/images.jpg",
15 },
16 email: {
17 type: String,
18 required: true,
19 unique: true,
20 lowercase: true,
21 match: /^\w+([\.-]?\w+)*@\w+([\.-]?\w+)*\.(\w{2,})+$/,
22 },
23 password: {
24 type: String,
25 required: true,
26 minlength: 8,
27 },
28 created_at: {
29 type: Date,
30 default: Date.now,
31 },
32 updated_at: {
33 type: Date,
34 default: Date.now,
35 },
36});
37
38const User = models?.User || model<USER_DTO>("User", userSchema);
39export default User;
40
41
常用API
可以熟悉以下常用的语法。
1
2**增**：Modal.save()
3
4**删**：Modal.deleteOne({name: 'xxx'})
5
6**改**：Modal.findByIdAndUpdate(id, { name: 'jason bourne' }, options)
7
8**查**：：Modal.deleteOne({ name: 'xxx })
9
每种操作都有很多种方法，可以按需使用，具体文档查找, model操作
到这里我们就基本完成了数据库的部分，可以进入到下一阶段登录。
登录
登录使用next-auth，这里可以很方便的让我实现第三方的登录。
NEXT-AUTH安装
1pnpm add next-auth
初始化配置
新建配置，在 lib目录中创建 auth_option.ts，这边我打算使用自定义登录以及github和google登录，微信登录看了一下需要注册企业，个人的话也要交钱，所以就暂时没有接入，短信登录需要接入短信服务，也要收费。
申请Github登录
进入 GitHub 之后，打开 Settings 中的 Developer Settings，点击左侧的 OAuth Apps 后，再点击右边的按钮 New OAuth App，创建一个新的配置。
，然后一步步往下走新建成功后，即可以拿到 CLIENT_ID和 Secret，可以把这些内容维护到 env文件中
然后完成以下配置。
1import GitHubProvider from "next-auth/providers/github";
2import GoogleProvider from "next-auth/providers/google";
3import CredentialsProvider from "next-auth/providers/credentials";
4import User from "models/user";
5import connectMongo from "@/lib/mongoose";
6import { decrypt, encrypt } from "@/lib/crypto";
7import { AuthOptions } from "next-auth";
8
9export const authOptions: AuthOptions = {
10 secret: process.env.SECRET_KEY,
11
12 debug: true,
13 providers: [
14 GitHubProvider({
15 clientId: process.env.GIT_CLIENT_ID as string,
16 clientSecret: process.env.GIT_CLIENT_SECRET as string,
17 httpOptions: {
18 timeout: 100000,
19 },
20
21 async profile(profile) {
22 try {
23
24 await connectMongo();
25
26
27 const existingUser = await User.findOne({ email: profile.email });
28
29
30
31 if (existingUser) {
32
33 const res = await User.findByIdAndUpdate(existingUser._id, {
34 name: profile.name || profile.login,
35 image: profile.avatar_url,
36 });
37 return existingUser;
38 }
39
40
41 const newUser = new User({
42 name: profile.name || profile.login,
43 email: profile.email,
44 image: profile.avatar_url,
45 password: encrypt(profile.id.toString()),
46 });
47
48 await newUser.save();
49
50 return newUser;
51 } catch (e: any ) {
52 console.log(e.message);
53 }
54 },
55 }),
56 GoogleProvider({
57 clientId: process.env.GOOGLE_ID as string,
58 clientSecret: process.env.GOOGLE_SECRET_KEY as string,
59 httpOptions: {
60 timeout: 100000,
61 },
62 }),
63 CredentialsProvider({
64 name: "Credentials",
65 credentials: {
66 email: {
67 label: "用户名",
68 type: "text",
69 placeholder: "请输入用户名",
70 },
71 password: {
72 label: "密码",
73 type: "password",
74 placeholder: "请输入密码",
75 },
76 },
77
78
79 async authorize(credentials, req) {
80
81 if (!credentials?.email || !credentials?.password) {
82 return null
83 }
84 await connectMongo();
85
86 const user = await User.findOne({ email: credentials.email });
87
88 if (!user) {
89 throw Error('用户不存在，请检查邮箱是否正确')
90 } else {
91 if (credentials.password === decrypt(user?.password as string)) {
92 return user
93 } else {
94 throw Error('密码不正确，请重新输入')
95 }
96 }
97 },
98 }),
99 ],
100
101 session: {
102 strategy: "jwt",
103 maxAge: 2 * 24 * 60 * 60,
104 },
105
106
107 callbacks: {
108 session: async (data: { session: any; }) => {
109 return data.session;
110 },
111 },
112
113 pages: {
114 signIn: "/",
115 },
116 }
创建路由
在 api下创建，[...nextauth]/route.ts
1import { authOptions } from "@/lib/auth_options";
2import NextAuth from "next-auth";
3
4const handler = NextAuth(authOptions);
5
6export { handler as GET, handler as POST };
7
编写登录组件
通过调用 signIn的方法传入不同的参数即可实现对应的登录。
1"use client";
2import { ChangeEvent, FocusEvent, FormEvent, useEffect, useState } from "react";
3import loginStyle from "./login.module.scss";
4import classnames from "classnames";
5import { motion } from "framer-motion";
6import LoginBox from "./component/LoginBox";
7import { Modal, Divider, Button, Input } from "antd";
8import { post } from "lib/fetch";
9import { signIn } from "next-auth/react";
10import { SwapOutlined } from "@ant-design/icons";
11
12interface FormState {
13 password: string;
14 email: string;
15}
16
17export default function LoginModal(data: {
18 open: boolean;
19 className?: string;
20 onClose?: () => void;
21}) {
22 const [formState, setFormState] = useState<FormState>({
23 email: "",
24 password: "",
25 });
26
27
28
29 const login = () => {
30 signIn("credentials", { ...formState });
31 };
32
33 const confirm = () => {
34 if (isLogin) {
35 login();
36 }
37 };
38 const [isLogin, setIsLogin] = useState(true);
39 return (
40 <>
41 <Modal
42 open={data.open}
43 destroyOnClose
44 width={500}
45 footer={null}
46 onClose={data.onClose}
47 onCancel={data.onClose}
48 >
49 <section>
50 <div className="flex flex-col items-center justify-center gap-6 pt-8">
51 <div className="flex items-center w-full">
52 <h2 className="text-2xl font-bold text-black">
53 {isLogin ? "登录" : "注册"}
54 <Button
55 type={"text"}
56 onClick={() => setIsLogin(!isLogin)}
57 icon={<SwapOutlined />}
58 >
59 <span className="sr-only">
60 {isLogin ? "Switch to Register" : "Switch to Login"}
61 </span>
62 </Button>
63 </h2>
64 </div>
65 <div className="w-full space-y-4">
66 <div className="space-y-2">
67 <label htmlFor="email">邮箱</label>
68 <Input
69 id="email"
70 placeholder="请输入邮箱"
71 onChange={(event: ChangeEvent<HTMLInputElement>) => {
72 setFormState({
73 email: event.target.value,
74 password: formState.password,
75 });
76 }}
77 />
78 </div>
79 <div className="space-y-2">
80 <label htmlFor="password">密码</label>
81 <Input
82 id="password"
83 type="password"
84 placeholder="请输入密码"
85 onChange={(event: ChangeEvent<HTMLInputElement>) => {
86 setFormState({
87 password: event.target.value,
88 email: formState.email,
89 });
90 }}
91 />
92 </div>
93 {!isLogin && (
94 <div className="space-y-2">
95 <label htmlFor="password">验证码</label>
96 <div>
97 <Input
98 id="password"
99 type="password"
100 placeholder="请输入验证码"
101 style={{ width: "250px" }}
102 />
103 <Button>发送验证码</Button>
104 </div>
105 </div>
106 )}
107 </div>
108 <Button className="w-full" type="primary" onClick={() => confirm()}>
109 <div className=" tracking-[] ">{isLogin ? "登 录" : "注 册"}</div>
110 </Button>
111 </div>
112 <Divider>或</Divider>
113 <LoginBox />
114 </section>
115 </Modal>
116 </>
117 );
118}
119
120// loginBox
121
122import { signIn } from "next-auth/react";
123import { Button } from "antd";
124import { GithubOutlined, GoogleOutlined } from "@ant-design/icons";
125
126export default function LoginBox() {
127 const sign = async (type: "github" | "google") => {
128 await signIn(type, {
129 callbackUrl: location.origin,
130 });
131 };
132 return (
133 <>
134 <div className="text-xl">
135 <Button
136 type="primary"
137 className="w-full !bg-[#24292F] mb-4"
138 onClick={() => sign("github")}
139 icon={<GithubOutlined></GithubOutlined>}
140 >
141 Login With Github
142 </Button>
143
144 <Button
145 color="red"
146 className="w-full"
147 onClick={() => sign("google")}
148 icon={<GoogleOutlined></GoogleOutlined>}
149 >
150 Login With Google
151 </Button>
152 </div>
153 </>
154 );
155}
156
157
在页面上点击登录，弹出登录窗口。 
登录成功后可以看到，返回了信息以及在 cookie中写入了token.
这样我们就完成了登录，注册还没做可以用一个 nodemailer来实现发送验证码，数据存储在 redis，缓存有效期1分钟，注册的时候验证以下验证码即可，密码加密存入数据库即可。
到此我们的准备工作基本上都做完了，现在就是业务开发了，这边直接不说了，没什么说的。
打包
直接使用 pnpm build即可打包，记住，打包的时候dev模式需要停止。
CI
这里使用 GITHUB_ACTION完成，在 .github下新增一个 nodejs.yml，添加如下内容。
具体操作就是使用 ssh登录到服务端。
然后执行拉取代码和打包的操作
1cd /www/blog-offical && git pull && pnpm install && pnpm build
1name: deploy
2on:
3 push:
4 branches: [main]
5 pull_request:
6 branches: [main]
7
8jobs:
9 build:
10 runs-on: ubuntu-latest
11 steps:
12 - name: executing remote ssh commands
13
14 uses: appleboy/ssh-action@master
15 with:
16 host: ${{secrets.DEPLOY_HOST}}
17 username: ${{secrets.DEPLOY_USER}}
18 password: ${{secrets.DEPLOY_PASS_WORD}}
19 script: cd /www/blog-offical && git pull && pnpm install && pnpm build && pm2 stop all && pm2 delete blog && pm2 start --name blog npm -- run start
20
CD
构建完成了，我们需要部署，部署的话我们采用 nginx来作为web服务器，使用 pm2来管理进程，确保稳定性。
Nginx
一般linux系统安装，是通过 yum install nginx来完成，安装目录在 /etc/nginx
这是Nginx的配置，开启了转发，http2，以及跨域问题，以及 https https的配置需要申请证书，一般都有免费的，只是时间比较短，需要经常更换。
1
2user nginx;
3worker_processes auto;
4error_log /var/log/nginx/error.log;
5pid /run/nginx.pid;
6
7# Load dynamic modules. See /usr/share/doc/nginx/README.dynamic.
8include /usr/share/nginx/modules/*.conf;
9
10events {
11 worker_connections 1024;
12}
13
14http {
15 log_format main '$remote_addr - $remote_user [$time_local] "$request" '
16 '$status $body_bytes_sent "$http_referer" '
17 '"$http_user_agent" "$http_x_forwarded_for"';
18
19 access_log /var/log/nginx/access.log main;
20
21 sendfile on;
22 tcp_nopush on;
23 tcp_nodelay on;
24 keepalive_timeout 65;
25 types_hash_max_size 2048;
26
27 include /etc/nginx/mime.types;
28 default_type application/octet-stream;
29
30 # Load modular configuration files from the /etc/nginx/conf.d directory.
31 # See http://nginx.org/en/docs/ngx_core_module.html#include
32 # for more information.
33 include /etc/nginx/conf.d/*.conf;
34
35 server {
36 listen 80 default_server;
37 listen [::]:80 default_server;
38 server_name _;
39 root /usr/share/nginx/html;
40 # Load configuration files for the default server block.
41 include /etc/nginx/default.d/*.conf;
42
43 location / {
44 # 添加以下配置以启用 CORS
45 if ($request_method = 'OPTIONS') {
46 add_header 'Access-Control-Allow-Origin' '*';
47 add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, DELETE, PUT';
48 add_header 'Access-Control-Allow-Headers' 'Origin, Authorization, Accept, Content-Type, X-Requested-With';
49 add_header 'Access-Control-Max-Age' 1728000;
50 add_header 'Content-Type' 'text/plain charset=UTF-8';
51 add_header 'Content-Length' 0;
52 return 204;
53 }
54
55 add_header 'Access-Control-Allow-Origin' '*';
56 add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, DELETE, PUT';
57 add_header 'Access-Control-Allow-Headers' 'Origin, Authorization, Accept, Content-Type, X-Requested-With';
58
59 proxy_pass http://localhost:3000; # 将请求转发到本地主机的 3000 端口
60 proxy_set_header Host $host;
61 proxy_set_header X-Real-IP $remote_addr;
62 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
63 proxy_set_header X-Forwarded-Proto $scheme;
64 }
65
66 error_page 404 /404.html;
67 location = /40x.html {
68 }
69
70 error_page 500 502 503 504 /50x.html;
71 location = /50x.html {
72 }
73 }
74
75# Settings for a TLS enabled server.
76
77 server {
78 listen 443 ssl http2 default_server;
79 listen [::]:443 ssl http2 default_server;
80 server_name _;
81 root /usr/share/nginx/html;
82
83 ssl_certificate "/www/cer/www.super-super.cn_bundle.pem";
84 ssl_certificate_key "/www/cer/www.super-super.cn.key";
85 ssl_session_cache shared:SSL:1m;
86 ssl_session_timeout 10m;
87 ssl_ciphers PROFILE=SYSTEM;
88 ssl_prefer_server_ciphers on;
89
90 # Load configuration files for the default server block.
91 include /etc/nginx/default.d/*.conf;
92
93 location / {
94 if ($request_method = 'OPTIONS') {
95 add_header 'Access-Control-Allow-Origin' '*';
96 add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, DELETE, PUT';
97 add_header 'Access-Control-Allow-Headers' 'Origin, Authorization, Accept, Content-Type, X-Requested-With';
98 add_header 'Access-Control-Max-Age' 1728000;
99 add_header 'Content-Type' 'text/plain charset=UTF-8';
100 add_header 'Content-Length' 0;
101 return 204;
102 }
103
104 add_header 'Access-Control-Allow-Origin' '*';
105 add_header 'Access-Control-Allow-Methods' 'GET, POST, OPTIONS, DELETE, PUT';
106 add_header 'Access-Control-Allow-Headers' 'Origin, Authorization, Accept, Content-Type, X-Requested-With';
107
108 proxy_pass http://localhost:3000; # 将请求转发到本地主机的 3000 端口
109 proxy_set_header Host $host;
110 proxy_set_header X-Real-IP $remote_addr;
111 proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
112 proxy_set_header X-Forwarded-Proto $scheme;
113 }
114
115 error_page 404 /404.html;
116 location = /40x.html {
117 }
118
119 error_page 500 502 503 504 /50x.html;
120 location = /50x.html {
121 }
122 }
123
124}
125
常用命令
启动服务
1nginx
停止服务
1nginx -s stop
重新加载，因为一般重新配置之后，不希望重启服务，这时可以使用重新加载。
1nginx -s realod
域名解析
主要说一下域名解析的过程以及记录值的区别。
SEO相关
Metadata
在NextJs中，提供了设置metadata的方式，设置在page.tsx或者layout.tsx.
分为静态和动态两种。
静态metadata
静态的metadata直接export一个metada对象即可。
1import type { Metadata, Viewport } from "next";
2
3const APP_NAME = "Blog";
4const APP_DEFAULT_TITLE = "汪浩的博客";
5const APP_TITLE_TEMPLATE = "博客";
6const APP_DESCRIPTION = "汪浩（Isaac Wang）的博客，一些关于技术和生活的的记录";
7
8export const metadata: Metadata = {
9 keywords:
10 "博客，汪浩，Isaac Wang, Javascript, Vue, Css, Nextjs, React, TypeScript, NextJs, NestJs, Nodejs, Docker, web3，区块链",
11 applicationName: APP_NAME,
12 title: {
13 default: APP_DEFAULT_TITLE,
14 template: APP_TITLE_TEMPLATE,
15 },
16 description: APP_DESCRIPTION,
17 manifest: "./manifest.json",
18 appleWebApp: {
19 capable: true,
20 statusBarStyle: "default",
21 title: APP_DEFAULT_TITLE,
22
23 },
24 formatDetection: {
25 telephone: false,
26 },
27 openGraph: {
28 type: "website",
29 siteName: APP_NAME,
30 title: {
31 default: APP_DEFAULT_TITLE,
32 template: APP_TITLE_TEMPLATE,
33 },
34 description: APP_DESCRIPTION,
35 },
36 twitter: {
37 card: "summary",
38 title: {
39 default: APP_DEFAULT_TITLE,
40 template: APP_TITLE_TEMPLATE,
41 },
42 description: APP_DESCRIPTION,
43 },
44};
然后就会在页面上得到解析，会被加载到head中。
动态Metadata
比如我们一些详情页，希望我们的标题是详情的title，content是详情的内容。这时候我们就可以用，例如博客的详情页面，这时候我们可以先获取到数据，然后使用generateMetadata函数来生成动态的metadata，如下：
1
2
3export async function generateMetadata({
4 params,
5}: {
6 params: { id: string };
7}): Promise<Metadata> {
8 const detail = await getBlogDetail(params.id);
9
10 if (!detail) {
11 return {};
12 }
13
14 return {
15 title: detail.title,
16 description: detail.content,
17 keywords: detail.tags.join(","),
18 category: detail.categories.join(", "),
19 abstract: detail.abstract,
20 creator: "汪浩（isaac wang）",
21 authors: [
22 { url: "https://github.com/wanghao1993", name: "汪浩（isaac wang）" },
23 ],
24 publisher: "汪浩（isaac wang）",
25 };
26}
27
此时我们就可以在这里看到，刚刚动态配置的metadata。
Sitemap
sitemap叫站点地图，可帮助搜索引擎更有效地发现您的网页并为其建立索引，也分为动态和静态两种。
静态的，可以建立一个文件叫app/sitemap.xml，如下。
1<?xml version="1.0" encoding="UTF-8"?>
2<urlset
3 xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
4 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
5 xsi:schemaLocation="http://www.sitemaps.org/schemas/sitemap/0.9
6 http://www.sitemaps.org/schemas/sitemap/0.9/sitemap.xsd">
7
8<url>
9 <loc>https://www.super-super.cn/</loc>
10 <lastmod>2024-07-22T07:08:29+00:00</lastmod>
11 <priority>1.00</priority>
12</url>
13<url>
14 <loc>https://www.super-super.cn/blog</loc>
15 <lastmod>2024-07-22T07:08:29+00:00</lastmod>
16 <priority>0.80</priority>
17</url>
18<url>
19 <loc>https://www.super-super.cn/about</loc>
20 <lastmod>2024-07-22T07:08:29+00:00</lastmod>
21 <priority>0.80</priority>
22</url>
23</urlset>
动态的可以建立一个文件叫app/sitemap.ts，如下
1import { MetadataRoute } from 'next'
2
3export default function sitemap(): MetadataRoute.Sitemap {
4 return [
5 {
6 url: 'https://acme.com',
7 lastModified: new Date(),
8 changeFrequency: 'yearly',
9 priority: 1,
10 },
11 {
12 url: 'https://acme.com/about',
13 lastModified: new Date(),
14 changeFrequency: 'monthly',
15 priority: 0.8,
16 },
17 {
18 url: 'https://acme.com/blog',
19 lastModified: new Date(),
20 changeFrequency: 'weekly',
21 priority: 0.5,
22 },
23 ]
24}
实施开放图谱和 Twitter 卡：
OpenGraph，又叫OG协议，可以简单的看一下介绍。
Twitter 卡片标签看上去与开放图谱标签相似，基于与开放图谱协议相同的约定。当使用开放图谱协议描述页面上的数据时，很容易生成 Twitter 卡片，而无需复制标签和数据。当 Twitter 卡片处理器在页面上寻找标签时，它会首先检查 Twitter 特定的属性；如果不存在，则会返回受支持的开放图谱属性。它允许在页面上独立定义这两种属性，并最大程度减少描述内容和体验所需的标记复制量。
如何定义呢，也是在metadata中定义，openGraph和twitter。
1 openGraph: {
2 type: "website",
3 siteName: APP_NAME,
4 title: {
5 default: APP_DEFAULT_TITLE,
6 template: APP_TITLE_TEMPLATE,
7 },
8 description: APP_DESCRIPTION,
9 },
10 twitter: {
11 card: "summary",
12 title: {
13 default: APP_DEFAULT_TITLE,
14 template: APP_TITLE_TEMPLATE,
15 },
16 description: APP_DESCRIPTION,
17 },
18};
19
此时我们可以看到在metadata中多了几个。
语义化标签
语义化的标签在SEO中也起到了很关键的作用，平时开发的时候也是需要注意的，这些都会被搜索引擎发现，比如p,article,img.alt等等标签都是会被作为seo的考虑的因素。
robots.txt
当我们的网站发布时，搜索引擎将会尝试去抓取我们的内容，这个时候robots.txt可以规定能够被抓取的范围。
1User-Agent: * // 意思是任何搜索引擎都可以
2Allow: / // 允许抓取任何内容
3Disallow: /admin // /admin下的内容不允许
4
5Sitemap: https://super-super.cn/sitemap.xml // sitemap的地址
这是google的seo文档，介绍的很详细Google_SEO
未完成
-
PWA
- 通过next-pwa，manifast完成PWA
-
埋点
- 接入百度统计和谷歌统计
-
响应式
-
全局搜索/标签搜索
-
评论
-
社交分享 …
如果你看完了点个star. 相关代码Blog
个人笔记记录 2021 ~ 2025