前言
日常工作中,当我们需要搭建临时文件系统或者站点的时候,我们通常会使用 python
自带的 http.server
模块或者 nginx
或者 node
来实现。但是他们都需要安装环境或者下载软件做很多的配置才可以,今天我们就来介绍一款可以不用部署环境,不用复杂配置,一个可执行文件就可以搭建生产级的 http
服务。
关于 caddy
caddy
是使用 go
语言编写的一个轻量级高性能的 web
服务器。对比传统 web
服务器它拥有很多的优点。
- 轻量
- 高性能
- 使用配置简单
- 默认支持
https
- 支持
HTTP/1.1、HTTP/2
- 支持
IPV6
- 支持
Markdown
- 全平台支持等等
实践
下载 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
比较厉害的一个功能就是可以直接渲染 markdown
为 html
。
但是要将 markdown
渲染为 html
,单独是用 Caddy
是不行的,我们需要借助 Caddyfile
对我们的服务器进行简单的配置。
我们在站点根路径创建 Caddyfile
,并写入以下内容
localhost:8000
file_server
templates {
mime .md text/html
}
- 表示我们的站点监听
8000
端口 - 表示我们以静态文件服务器的模式启动
Caddy
- 表示我们的模板
templates
中的md
文件需要渲染为html
然后我们在根路径创建一个名为 templates
的文件夹,然后在其中创建一个名为 demo.md
的 markdown
文件,并写入以下内容:
# 这是 md 的 h1
> 这是 md 的引用
```python
def sayHi():
print('hi,Python全栈开发!')
```
- 序列 1
- 序列 2
然后我们在 index.html
中就可以引用这个 markdown
文件,Caddy
会自动将 markdown
内容渲染为 html
。
<!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
前已经带上了小锁子