跳到主要内容

Caddy Server

· 阅读需 4 分钟
ahKevinXy
ahKevinXy
作者

Caddy Server（Caddy 服务器），Caddy 是一款现代化、开源的可扩展服务器平台，核心特点是默认启用 HTTPS，以下是对该仓库的详细介绍：

一、核心定位​

Caddy 是一款用 Go 语言编写的 HTTP/HTTPS 服务器，区别于 Nginx、Apache 等传统服务器，它以“零配置默认 HTTPS”为核心设计理念，主打易用性、安全性和可扩展性，适用于从个人站点到企业级生产环境的各类场景。

二、核心特性（从仓库 README 及代码结构推导）​

  1. 默认 HTTPS 体验

    • 自动从 ZeroSSL、Let's Encrypt 等机构获取并管理公网域名的 TLS 证书；
    • 为内网域名/IP 提供本地 CA 管理能力，支持集群化证书协调、多签发方降级容错，还支持 Encrypted ClientHello (ECH)；
    • 能避免因 TLS/OCSP/证书问题导致的服务宕机，稳定性经过海量请求（万亿级）和数百万证书管理的生产验证。

  2. 灵活的配置方式

    • 简洁的 Caddyfile 配置语法（低门槛）；
    • 原生 JSON 配置（高灵活性）；
    • 支持 JSON API 动态修改配置，也可通过配置适配器兼容其他格式。

  3. 高性能与兼容性

    • 默认支持 HTTP/1.1、HTTP/2、HTTP/3 协议；
    • 可扩展至数十万个站点，满足高并发生产场景；
    • 无外部依赖（甚至不依赖 libc），可跨平台运行（Windows/Linux/macOS 等）。

  4. 可扩展性与安全性

    • 模块化架构（从代码目录如 caddyconfig/、internal/、各类 *.go 插件式文件可体现），支持自定义扩展，无冗余功能；
    • Go 语言的内存安全特性降低了传统服务器的内存漏洞风险；
    • 无第三方依赖，进一步减少安全攻击面。

三、代码库结构（从 folder_tree 看核心文件/目录）​

  • 核心源码文件：caddy.go（主入口）、listen*.go（监听相关，含不同系统的 Unix 套接字/端口复用逻辑）、context.go（上下文管理）、filesystem.go（文件系统适配）等，覆盖服务器核心运行逻辑；
  • 配置相关：caddyconfig/ 目录处理配置解析（Caddyfile/JSON 等）；
  • 测试相关：caddytest/、各类 *_test.go 文件（如 admin_test.go）保障代码可靠性；
  • 工程化配置：.golangci.yml（Go 代码规范检查）、.goreleaser.yml（发布打包）、go.mod/go.sum（Go 模块依赖）等，符合现代化 Go 项目工程规范；
  • 工具/命令：cmd/ 目录包含 Caddy 命令行工具的实现；
  • 文档/协议：README.md（核心介绍）、AUTHORS（贡献者）、LICENSE（开源协议）、AGENTS.md 等，完善的开源项目配套文档。

四、安装与使用​

  • 最简方式：从 GitHub Releases 下载跨平台可执行文件，放入系统 PATH 即可运行；
  • 也支持从源码构建（开发/定制化场景），支持注入版本信息、集成自定义插件。

五、适用场景​

  • 个人/小型站点：零配置快速搭建 HTTPS 服务；
  • 企业生产环境：高可用、高扩展的多站点管理；
  • 定制化网关/中间件：基于模块化架构扩展成反向代理、API 网关等。

六、生态与支持​

综上，这个仓库是 Caddy 服务器的核心代码载体，不仅提供了服务器运行的核心逻辑，还通过完善的工程化配置、测试体系和文档，支撑起一款“易用、安全、可扩展”的现代化服务器生态。

Docker Compose 教程

· 阅读需 3 分钟
ahKevinXy
ahKevinXy
作者

什么是 Docker Compose？​

Docker Compose 是一个用于定义和运行多容器 Docker 应用程序的工具。通过一个 YAML 文件（通常是 docker-compose.yml），你可以配置应用程序的服务、网络和卷，然后使用单个命令来启动、停止和管理整个应用程序。

Docker Compose 特别适用于开发、测试和 CI/CD 环境，因为它简化了多容器应用的部署和管理。

安装 Docker Compose​

Docker Compose 通常与 Docker Desktop 一起安装。如果你使用的是 Linux，可以单独安装：

# 下载最新版本
sudo curl -L "https://github.com/docker/compose/releases/download/v2.24.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

# 给执行权限
sudo chmod +x /usr/local/bin/docker-compose

# 验证安装
docker-compose --version

基本概念​

docker-compose.yml 文件​

这是 Docker Compose 的核心配置文件。它的结构如下：

version: '3.8'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"
  db:
    image: postgres:13
    environment:
      POSTGRES_PASSWORD: example
  • version: 指定 Compose 文件格式版本
  • services: 定义要运行的容器
  • image: 指定容器镜像
  • ports: 端口映射
  • environment: 环境变量

简单示例：运行一个 Web 应用​

让我们创建一个简单的示例，包括一个 Flask 应用和一个 Redis 数据库。

1. 创建项目目录​

mkdir docker-compose-tutorial
cd docker-compose-tutorial

2. 创建 Flask 应用​

创建 app.py：

from flask import Flask
import redis

app = Flask(__name__)
r = redis.Redis(host='redis', port=6379)

@app.route('/')
def hello():
    r.incr('hits')
    return f'Hello World! This page has been viewed {r.get("hits").decode("utf-8")} times.'

if __name__ == "__main__":
    app.run(host="0.0.0.0", debug=True)

3. 创建 requirements.txt​

Flask==2.3.3
redis==4.6.0

4. 创建 Dockerfile​

FROM python:3.9-slim

WORKDIR /app

COPY requirements.txt .
RUN pip install -r requirements.txt

COPY app.py .

CMD ["python", "app.py"]

5. 创建 docker-compose.yml​

version: '3.8'
services:
  web:
    build: .
    ports:
      - "5000:5000"
    depends_on:
      - redis
  redis:
    image: "redis:alpine"

6. 运行应用​

docker-compose up --build

访问 http://localhost:5000，你应该看到计数器在增加。

常用命令​

  • docker-compose up: 启动服务
  • docker-compose down: 停止并删除服务
  • docker-compose build: 构建或重新构建服务
  • docker-compose logs: 查看服务日志
  • docker-compose ps: 列出运行中的容器
  • docker-compose exec <service> <command>: 在运行中的容器中执行命令

高级用法​

环境变量​

你可以使用 .env 文件来管理环境变量：

# .env
POSTGRES_USER=myuser
POSTGRES_PASSWORD=mypassword

在 docker-compose.yml 中：

services:
  db:
    image: postgres
    env_file:
      - .env

卷（Volumes）​

持久化数据：

services:
  db:
    image: postgres
    volumes:
      - postgres_data:/var/lib/postgresql/data

volumes:
  postgres_data:

网络​

自定义网络：

services:
  web:
    networks:
      - frontend
  db:
    networks:
      - backend

networks:
  frontend:
  backend:

总结​

Docker Compose 让多容器应用的开发和部署变得简单。通过学习这些基本概念和命令，你可以开始构建更复杂的应用程序。记得查看官方文档以获取更多详细信息：https://docs.docker.com/compose/

go wails 如何开发桌面程序

· 阅读需 9 分钟
ahKevinXy
ahKevinXy
作者

Wails 是一款基于 Go 语言的跨平台桌面应用开发框架，核心优势是用 Go 编写后端逻辑 + 前端技术（HTML/CSS/JS/Vue/React）编写 UI，无需打包完整浏览器内核（如 Electron），生成的程序体积更小（MB 级）、启动更快、资源占用更低。

本文将从环境搭建、项目创建、核心特性、实战开发、打包发布五个维度，手把手教你用 Wails 开发桌面程序。