Fiber야, 정적 서빙 만들어줘. 2강: 정적 서빙을 사용해 보기
by
gg582 · 2026-11-20 02:27:36 · 13 views · 3 min read
앞서서
우리가 1강에서 파일을 서빙할 때, 직접 확장자를 지정하고, 파일을 따로 읽어 와서 전송했습니다. 하지만 Fiber는 정적 서빙 기능을 제공할 뿐더러, HTML 템플릿 역시 쉽게 처리할 수 있게 해 줍니다.
앞선 예제의 흐름대로 소스를 살펴 봅시다.
소스 (0003-hello-staticserve.zip)
main.go
package main
import (
"embed"
"html/template"
"io/fs"
"log"
petname "github.com/dustinkirkland/golang-petname"
"github.com/gofiber/fiber/v3"
"github.com/gofiber/fiber/v3/middleware/static"
)
//go:embed assets/index.html assets/gopher.svg
var assets embed.FS
// index.html 템플릿을 data로 렌더링해서 보낸다.
func renderIndex(tmpl *template.Template, c fiber.Ctx, name string) error {
c.Set(fiber.HeaderContentType, "text/html; charset=utf-8")
return tmpl.Execute(c, struct{ Name string }{Name: name})
}
// "형용사-동물" 꼴의 랜덤 닉네임을 만든다.
func newNickname() string {
return petname.Generate(2, "-")
}
func main() {
// embed.FS의 "assets/" 접두사를 떼어낸 하위 FS.
// static 미들웨어의 루트로 쓴다.
assetsFS, err := fs.Sub(assets, "assets")
if err != nil {
log.Fatal(err)
}
// HTML의 몸체. {{.Name}} 자리만 라우트마다 바뀌므로 정적 서빙이 아니라 템플릿으로 읽는다.
// ParseFS가 FS에서 직접 읽어 오므로 수동 ReadFile이 필요 없다. 실패하면 Must가 panic한다.
indexTmpl := template.Must(template.ParseFS(assetsFS, "index.html"))
// Fiber 앱을 생성함.
app := fiber.New()
// 먼저 HTML부터 서빙한다. 이 HTML에서는 URL의 형태로 고퍼 이모티콘을 받아오려 시도할 것이다.
app.Get("/", func(c fiber.Ctx) error {
return renderIndex(indexTmpl, c, "Fiber")
})
// 고퍼 이모티콘은 static 미들웨어가 FS에서 읽어 서빙한다.
// Content-Type(확장자 기반), Last-Modified, Range 등은 미들웨어가 알아서 처리한다.
// 템플릿 원본(index.html)이 그대로 노출되지 않도록 디렉터리 전체가 아닌 단일 파일만 연결한다.
app.Get("/gopher.svg", static.New("gopher.svg", static.Config{FS: assetsFS}))
// 홈의 "Click to get a nickname" 버튼이 여기로 온다.
// 랜덤 닉네임을 만들어 /hello/<nickname> 로 리다이렉트하여, URL 경로 파라미터로 전달한다.
app.Get("/nickname", func(c fiber.Ctx) error {
return c.Redirect().To("/hello/" + newNickname())
})
// :id 자리에 들어온 경로 파라미터를 c.Params로 꺼내서,
// 같은 HTML 폼을 유지한 채 "Hello, Fiber!" 대신 "Hello, <nickname>!"로 렌더링한다.
app.Get("/hello/:id", func(c fiber.Ctx) error {
return renderIndex(indexTmpl, c, c.Params("id"))
})
// 앱이 3000번 포트에서 듣지 못하면 역시 치명적인 오류로 간주하고 Fatal을 낸다.
log.Fatal(app.Listen(":3000"))
}
앞서서 우리가 직접 수행하던 부분의 상당수가 fiber에 의해 대체되었습니다. 여기서 우리가 주목해야 할 것은 템플릿 처리와 정적 서빙의 흐름입니다.
우선 이곳에서 HTML 템플릿을 불러 옵니다.
indexTmpl := template.Must(template.ParseFS(assetsFS, "index.html"))
이후 아랫줄에서 이 내용을 그대로 서빙합니다.
app.Get("/", func(c fiber.Ctx) error {
return renderIndex(indexTmpl, c, "Fiber")
})
이전에 비해 우리가 직접 구현해야 할 부분이 줄었습니다.
프레임워크가 읽어 준
indexTmpl을 받아서 익명 함수에서 꽂아 주기만 하면 그만입니다.
초기값은 "Fiber"로 설정하여 시작 화면의 Hello, Fiber! 형태를 유지합니다.
그렇다면 고퍼 이미지를 어떻게 삽입할까요?
우리는 앞서서 이미지의 정보를 직접 읽고, 확장자를 지정하여 보냈습니다. 그러나 이런 단일 파일에 대해 Fiber는 좋은 편의성을 제공합니다.
app.Get("/gopher.svg", static.New("gopher.svg", static.Config{FS: assetsFS}))
이 한 줄만 작성하면 확장자 설정, 이미지 읽어오기까지 지정된 FS인 assetsFS에서 받아 옵니다.
assetsFS는 윗줄에서 var assets embed.FS를 두어서, //go:embed assets/index.html assets/gopher.svg로 설정된 두 개의 파일을 포함한 FS이죠.
적어도 임베딩된 FS나 파일명을 모르지만 않는다면 손쉽게 정적 서빙할 수 있습니다. 앞선 강의의 UUID 생성과 마찬가지지만, 이번엔 친근한 닉네임을 써 보도록 하죠.
// 홈의 "Click to get a nickname" 버튼이 여기로 온다.
// 랜덤 닉네임을 만들어 /hello/<nickname> 로 리다이렉트하여, URL 경로 파라미터로 전달한다.
app.Get("/nickname", func(c fiber.Ctx) error {
return c.Redirect().To("/hello/" + newNickname())
})
나머지 부분은 완전히 동일합니다.
이제 고퍼 이미지의 정적 서빙만 편리해졌을 뿐이지, 큰 틀이 같다는 것을 익혔습니다.
그렇다면 , 임베드 FS가 아닌 추후에 파일을 새로 만들거나 지울 수 있는 파일 시스템을 사용한다면 웹 갤러리를 만들 수 있겠죠.
만약 유닉스에서 gallery/music과 gallery/pens 폴더가 있다면 아래와 같이 쉽게 서빙할 수 있겠습니다.
app.Get("/imgs/music", static.New("gallery/music", static.Config{FS: someGoodFS}))
app.Get("/imgs/pens", static.New("gallery/pens", static.Config{FS: someGoodFS}))
다음 강의에는 우선 두 개의 폴더를 만들고, POST 메소드를 이용해서 이미지를 업로드하거나 삭제할 수 있는 갤러리를 만든 후, 폴더 관리까지 사이트에서 할 수 있는 꼴로 확장하여 보겠습니다.]
Comments
No comments yet.