Golang 静态HTTP服务器快速部署插件serve的使用

在Golang中，我们可以使用serve库快速搭建一个静态HTTP服务器，用于本地开发测试或简单的文件共享。下面我将详细介绍如何使用这个工具。

安装serve

首先，我们需要安装serve库：

go get github.com/syntaqx/serve

基本使用方法

1. 最简单的方式

在项目目录下直接运行：

serve

这会启动一个服务器，默认监听0.0.0.0:3000，并将当前目录作为根目录。

2. 自定义端口和目录

serve -p 8080 -d ./public

• -p 指定端口号
• -d 指定要服务的目录

3. 使用Golang代码启动

你也可以直接在Go代码中使用这个库：

package main

import (
	"log"
	"github.com/syntaqx/serve"
)

func main() {
	// 创建服务器配置
	config := serve.Config{
		Port:    8080,
		Dir:     "./public",
		Verbose: true,
	}

	// 创建服务器实例
	server := serve.NewServer(config)

	// 启动服务器
	log.Printf("Server starting on :%d", config.Port)
	if err := server.ListenAndServe(); err != nil {
		log.Fatalf("Server failed: %v", err)
	}
}

高级功能

1. 启用HTTPS

config := serve.Config{
	Port:     443,
	Dir:      "./public",
	CertFile: "cert.pem",
	KeyFile:  "key.pem",
}

2. 自定义路由

config := serve.Config{
	Port: 8080,
	Dir:  "./public",
	Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		if r.URL.Path == "/custom" {
			w.Write([]byte("Custom route"))
			return
		}
		http.FileServer(http.Dir(config.Dir)).ServeHTTP(w, r)
	}),
}

3. 启用CORS

config := serve.Config{
	Port: 8080,
	Dir:  "./public",
	Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
		w.Header().Set("Access-Control-Allow-Origin", "*")
		w.Header().Set("Access-Control-Allow-Methods", "GET, POST, OPTIONS")
		w.Header().Set("Access-Control-Allow-Headers", "Content-Type")
		
		if r.Method == "OPTIONS" {
			return
		}
		
		http.FileServer(http.Dir(config.Dir)).ServeHTTP(w, r)
	}),
}

命令行参数完整列表

实际应用示例

1. 开发环境快速启动

# 在项目目录下
serve -p 3000 -d ./dist

2. 作为本地API模拟服务器

创建一个api目录，里面放上JSON文件，然后：

serve -p 3001 -d ./api

3. 在Go项目中集成

package main

import (
	"log"
	"net/http"
	"os"
	
	"github.com/syntaqx/serve"
)

func main() {
	// 检查环境变量
	port := "3000"
	if p := os.Getenv("PORT"); p != "" {
		port = p
	}

	// 配置服务器
	config := serve.Config{
		Port:    port,
		Dir:     "./public",
		Verbose: true,
		Handler: http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
			// 添加自定义中间件
			log.Printf("%s %s", r.Method, r.URL.Path)
			http.FileServer(http.Dir(config.Dir)).ServeHTTP(w, r)
		}),
	}

	// 启动服务器
	server := serve.NewServer(config)
	log.Printf("Starting server on :%s", port)
	if err := server.ListenAndServe(); err != nil {
		log.Fatalf("Server error: %v", err)
	}
}

总结

serve是一个轻量级的Golang静态文件服务器工具，非常适合：

1. 本地开发测试
2. 快速共享文件
3. 构建简单的Web服务原型
4. 作为微服务架构中的静态资源服务器

它的优势在于简单易用，既可以作为命令行工具快速启动，也可以集成到Go项目中作为库使用。