Caddy入门

2022-06-17 09:16:23 浏览数 (1)

前言

日常工作中,当我们需要搭建临时文件系统或者站点的时候,我们通常会使用 python 自带的 http.server 模块或者 nginx 或者 node 来实现。但是他们都需要安装环境或者下载软件做很多的配置才可以,今天我们就来介绍一款可以不用部署环境,不用复杂配置,一个可执行文件就可以搭建生产级的 http 服务。

关于 caddy

caddy 是使用 go 语言编写的一个轻量级高性能的 web 服务器。对比传统 web 服务器它拥有很多的优点。

  1. 轻量
  2. 高性能
  3. 使用配置简单
  4. 默认支持 https
  5. 支持 HTTP/1.1、HTTP/2
  6. 支持 IPV6
  7. 支持 Markdown
  8. 全平台支持等等

实践

下载 caddy

官网:https://caddyserver.com/

我们打开 Caddy 首页,点击下载,系统会根据我们的操作系统自动识别,为你下载合适的 Caddy 可执行文件。

Caddy 作为文件服务器

Caddy 就是一个二进制的文件,我们在站点根路径直接使用 caddy file-server 即可以文件服务器模式启动 Caddy

我们在浏览器访问 localhost 看看效果,你会发现无法访问,这是为什么呢?因为 Caddy 作为文件服务,如果没有 index 文件,就需要增加-browse 参数。

现在我们在浏览器访问 localhost 看看效果。

如上,Caddy 作为文件服务器界面很友好,可以根据名称排序,可以搜索过滤文档。

Caddy 作为网站服务器

我们将 Caddy 路径加到环境变量中,然后新建一个文件夹 demo,然后在 demo 中新建一个 index.html 的文件。然后 caddy file-server 启动服务看看效果。

因为我们的站点也是一对静态文件,当我们有了 index.html 文件,Caddy 就会自动识别并加载。

Caddy 渲染 markdown

Caddy 比较厉害的一个功能就是可以直接渲染 markdownhtml

但是要将 markdown 渲染为 html,单独是用 Caddy 是不行的,我们需要借助 Caddyfile 对我们的服务器进行简单的配置。

我们在站点根路径创建 Caddyfile,并写入以下内容

代码语言:javascript复制
localhost:8000
file_server
templates {
    mime .md text/html
}
  1. 表示我们的站点监听 8000 端口
  2. 表示我们以静态文件服务器的模式启动 Caddy
  3. 表示我们的模板 templates 中的 md 文件需要渲染为 html

然后我们在根路径创建一个名为 templates 的文件夹,然后在其中创建一个名为 demo.mdmarkdown 文件,并写入以下内容:

代码语言:javascript复制
# 这是 md 的 h1

> 这是 md 的引用

```python
def sayHi():
    print('hi,Python全栈开发!')
```

- 序列 1
- 序列 2

然后我们在 index.html 中就可以引用这个 markdown 文件,Caddy 会自动将 markdown 内容渲染为 html

代码语言:javascript复制
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <meta http-equiv="X-UA-Compatible" content="IE=edge">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Caddy</title>
</head>
<body>
    <h1>Welcome to Caddy World!</h1>
    <p>这是caddy的demo,由Python全栈开发分享!</p>
    <div>
    {{include "markdown/demo.md" | markdown}}
    </div>
</body>
</html>

此时我们执行 caddy run --watch 启动服务器,浏览器访问 localhost:8000 看看效果。

可以看到 Caddy 已经成功将 markdown 渲染为了 html,这是一个非常好的功能。

相信个别同学已经发现,在使用 Caddyfile 配置服务器后,Caddy 默认已经支持 https 协议,上面截图中的 URL 前已经带上了小锁子

0 人点赞