Fiber야, 내 이름을 불러 줘! 1강: Hello, Fiber와 파라미터 활용
by
gg582 · 2026-11-19 08:47:01 · 21 views · 8 min read
Table of contents
Fiber야, 안녕!
우선 Fiber 공식 튜토리얼에서 가져 온 예시를 봅시다.
main.go
package main
import (
"log"
"github.com/gofiber/fiber/v3"
)
func main() {
app := fiber.New()
app.Get("/", func(c fiber.Ctx) error {
return c.SendString("Hello, World!")
})
log.Fatal(app.Listen(":3000"))
}
기본적인 흐름은 간단합니다. 이 앱은 "/"(루트 경로)에서 "Hello, World!"라는 간단한 스트링을 전송합니다.
Fiber 서버를 실행하면 아래와 같은 아스키 아트와 설명문이 나옵니다. 마치 독일산 카메라를 살 때 들어 있던 종이 설명서같이 친절해서 좀 귀엽습니다.
_______ __
/ ____(_) /_ ___ _____
/ /_ / / __ \/ _ \/ ___/
/ __/ / / /_/ / __/ /
/_/ /_/_.___/\___/_/ v3.7.0
--------------------------------------------------
INFO Server started on: http://127.0.0.1:3000 (bound on host 0.0.0.0 and port 3000)
INFO Total handlers: 2
INFO Prefork: Disabled
INFO PID: 577003
INFO Total process count: 1
설명문에서 언급한 http://127.0.0.1:3000 주소를 웹 브라우저에 치고 들어갑니다.
만약 지금 서버를 실행해 두셨다면, 링크를 클릭해 보셔도 됩니다.
유닉스나 리눅스 숙련자 분들은 아래의 명령을 쓰셔도 됩니다.
string=$(curl http://localhost:3000 2>/dev/null) && echo "$string"
이 서버를 빌드하는 법이 이해되지 않는다면, Go언어 강의를 추천드립니다.
저의 경우 아래의 무료 강의를 이용해서 3주만에 기본적인 클라우드/웹 애플리케이션을 짤 정도로 늘었습니다.
링크 소스 (0000-hello-fiber-official.zip)
예쁜 웹페이지로 인사하기
단순 텍스트로도 기본적인 인사 페이지를 시험해 보기에 문제는 없습니다. 하지만 위 예제는 실제로 애플리케이션을 만들 때 나오는 기본적인 패턴을 충실하게 보여 주지 못합니다.
다시 말해 최소 예제라는 한계가 있습니다.
우리는 보기 좋은 웹사이트로 인사하게 만들어서, 조금 덜 지루하게 실습할 겁니다.
이 경우, HTML 및 사진이 포함된 에셋이 필요합니다. 아래의 첨부 파일을 다운로드하여 압축을 풀고, 소스를 빌드해 주세요.
main.go
package main
import (
"embed"
"log"
"github.com/gofiber/fiber/v3"
)
//go:embed assets/index.html assets/gopher.svg
var assets embed.FS
// 컨텐츠와 컨텐츠 유형을 받는다.
func serveAsset(content []byte, contentType string) fiber.Handler {
return func(c fiber.Ctx) error {
// fiber 컨텍스트 구조체에 fiber의 컨텐츠 타입(예: html)을 지정한다.
c.Set(fiber.HeaderContentType, contentType)
// 지정된 컨텐츠를 전송한다.
return c.Send(content)
}
}
// 파일을 읽지 못하면 Fatal
func mustRead(name string) []byte {
// 파일 읽기를 시도한다.
b, err := assets.ReadFile(name)
// 어떤 오류라도 발생했을 시
if err != nil {
// 치명적인 오류로 간주하고 Fatal을 낸다.
log.Fatal(err)
}
// 아무 문제도 없었으면, ReadFile을 통해 읽어 온 파일의 정보를 반환한다.
return b
}
func main() {
// HTML의 몸체
indexHTML := mustRead("assets/index.html")
// 고퍼 로고
gopherSVG := mustRead("assets/gopher.svg")
// Fiber 앱을 생성함.
app := fiber.New()
// 먼저 HTML부터 서빙한다. 이 HTML에서는 URL의 형태로 고퍼 이모티콘을 받아오려 시도할 것이다.
app.Get("/", serveAsset(indexHTML, "text/html; charset=utf-8"))
// 따라서 고퍼 이모티콘의 파일 내용을 /gopher.svg에서 서빙한다.
app.Get("/gopher.svg", serveAsset(gopherSVG, "image/svg+xml"))
// 앱이 3000번 포트에서 듣지 못하면 역시 치명적인 오류로 간주하고 Fatal을 낸다.
log.Fatal(app.Listen(":3000"))
}
물론 풀스택 개발자가 되기 위해선 HTML에 대한 이해가 필요하지만, 여기선 간단하게 "웹 브라우저에 UI 및 화면을 그리고, 사용자와 상호작용하기 위한 마크업 언어"정도로 퉁치고 넘어가겠습니다.
웹 브라우저에선 고퍼의 모습과 무난한 UI가 뜹니다. 그리고 "고퍼 사진"이 뜨고 있습니다. HTML 어디에도 SVG가 하드코딩되지 않았는데도요. 그렇다면 어떤 구조로 작동하는 걸까요?
gopherSVG := mustRead("assets/gopher.svg")
이 쪽 줄부터 잘 따라와 주세요. 우선 우변을 보고 mustRead 함수를 추적하고, 좌변의 gopherSVG 변수가 사용되는 흐름을 추적합니다.
// 파일을 읽지 못하면 Fatal
func mustRead(name string) []byte {
// 파일 읽기를 시도한다.
b, err := assets.ReadFile(name)
// 어떤 오류라도 발생했을 시
if err != nil {
// 치명적인 오류로 간주하고 Fatal을 낸다.
log.Fatal(err)
}
// 아무 문제도 없었으면, ReadFile을 통해 읽어 온 파일의 정보를 반환한다.
return b
}
mustRead 함수는 이름 그대로 파일을 읽어야만 하는 함수입니다. 이 함수가 파일을 읽는 데 실패했다면, log.Fatal 절에서 이미 프로그램은 오류를 알리며 종료합니다.
우리가 이전에 보았던 gopherSVG는 그럼 어디서 사용되고 있나요?
app.Get("/gopher.svg", serveAsset(gopherSVG, "image/svg+xml"))
이 줄에서 serveAsset함수의 첫 번째 요소로 삽입됩니다. 이제 serveAsset 함수를 보죠.
// 컨텐츠와 컨텐츠 유형을 받는다.
func serveAsset(content []byte, contentType string) fiber.Handler {
return func(c fiber.Ctx) error {
// fiber 컨텍스트 구조체에 fiber의 컨텐츠 타입(예: html)을 생성한다.
c.Set(fiber.HeaderContentType, contentType)
// 지정된 컨텐츠를 전송한다.
return c.Send(content)
}
}
이곳에선 c.SendString이 아닌 c.Send를 써서 보내고 있습니다. 이것은 "스트링 전송"이 아니며, 무엇을 전송하는지(즉 컨텐츠 타입)은 두 번째 요소로 contentType 변수를 받아서 c.Set 절에서 설정합니다.
잘 생각해 봅시다. 우리가 앞서서 사용한 이미지는 SVG 타입입니다.
그리고 첫 번째 요소에 파일의 내용, 두 번째 요소에 image/svg+xml을 씁니다.
하지만, 어디에도 파일명은 나와 있지 않죠?
당연합니다. SVG 파일에서 읽어온 스트링 안에는 그림을 그리기 위한 명세가 있지, 파일의 메타데이터까지 들어있진 않습니다.
하지만, 우리가 인터넷에 파일을 올릴 때를 생각해 볼까요?
https://someurl.mywebsite/assets/images/gopher.svg가 있다고 하면, 저장된 파일명은 뭐가 될까요?
이것이 gopher.svg로 저장된다는 것은 조금만 관찰력이 좋은 사람이라면 알 수 있습니다.
따라서, 우리가 작성하고자 하는 서버 역시 엔드포인트 URL에서 서빙할 파일명을 명시하면 됩니다.
엔드포인트라는 표현이 어려우면, 끝점이라고 이해하시고 말씀만 엔드포인트라고 하셔도 무관합니다.
app.Get("/gopher.svg", serveAsset(gopherSVG, "image/svg+xml"))
다시 가져 와서 보니, 구조가 보입니다. 마찬가지로, 이전엔 의미를 파악하지 못했던 "/" 역시 이해할 수 있어졌죠?
네이버같은 곳을 접속하면, https://naver.com/으로 /가 따라 붙잖아요.
그렇기 때문에, HTML도 같은 흐름을 탑니다.
파일 읽기
gopherSVG := mustRead("assets/gopher.svg")
읽은 내용으로 엔드포인트에서 서빙
app.Get("/", serveAsset(indexHTML, "text/html; charset=utf-8"))
그럼 이 서버의 진입점을 몸통이라고 하면, 이 프로그램은 가지가 두 개 달린 나무처럼 됩니다.
프로그램───── "/"
╰──── "/gopher.svg"
여기까진 왔는데, 어떻게 이미지가 "/" 주소로 들어가는지 보이지 않죠?
숙련자 분들은 아까 드린 curl 명령으로 받아 보시거나, 아니면 파워쉘 명령으로 HTML을 보시면 되지만, 코딩 입문자 분들은 아닙니다.
이제 사실은 svg가 "/" 주소로 들어가지 않는다는 것을 보일 겁니다.
압축 해제한 소스의 assets 폴더로 들어가서, index.html 파일을 여세요.
그럼 이런 줄이 보입니다.
<img src="/gopher.svg" alt="Official Go Gopher" />
여기서 아무 주소 없이 /gopher.svg로 주소가 들어간 것은, 우리가 만든 서버 프로그램과 같은 주소, 같은 포트(주소 뒤에 따라 붙는 숫자 3000)이라고 가정하고 파일을 불러 오겠다는 뜻입니다.
그럼 이미지의 원천(src, source)는 묵시적으로 http://localhost:3000/gopher.svg로 해석됩니다.
그리고 이 주소에 접속하면 서버는 아까 읽은 svg를 송신합니다.
따라서 브라우저는 그 파일을 수신하고, <img> 속성을 이용하여 이미지를 띄우게 되는 것입니다.
이것이 기본적인 골자입니다.
같은 원리로 파라미터를 써 보기
우선 아래 소스를 받고, 이 main.go를 같이 읽어 주세요.
main.go
package main
import (
"embed"
"html/template"
"log"
"github.com/gofiber/fiber/v3"
"github.com/google/uuid"
)
//go:embed assets/index.html assets/gopher.svg
var assets embed.FS
// 컨텐츠와 컨텐츠 유형을 받는다.
func serveAsset(content []byte, contentType string) fiber.Handler {
return func(c fiber.Ctx) error {
// fiber 컨텍스트 구조체에 fiber의 컨텐츠 타입(예: html)을 생성한다.
c.Set(fiber.HeaderContentType, contentType)
// 지정된 컨텐츠를 전송한다.
return c.Send(content)
}
}
// index.html 템플릿을 data로 렌더링해서 보낸다.
// html/template이 값을 자동으로 이스케이프하므로 퍼라미터에 HTML이 섞여 와도 안전하다.
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})
}
// 파일을 읽지 못하면 Fatal
func mustRead(name string) []byte {
// 파일 읽기를 시도한다.
b, err := assets.ReadFile(name)
// 어떤 오류라도 발생했을 시
if err != nil {
// 치명적인 오류로 간주하고 Fatal을 낸다.
log.Fatal(err)
}
// 아무 문제도 없었으면, ReadFile을 통해 읽어 온 파일의 정보를 반환한다.
return b
}
func main() {
// HTML의 몸체. {{.Name}} 자리만 라우트마다 바뀌는 템플릿으로 읽는다.
indexTmpl := template.Must(template.New("index").Parse(string(mustRead("assets/index.html"))))
// 고퍼 로고
gopherSVG := mustRead("assets/gopher.svg")
// Fiber 앱을 생성함.
app := fiber.New()
// 먼저 HTML부터 서빙한다. 이 HTML에서는 URL의 형태로 고퍼 이모티콘을 받아오려 시도할 것이다.
app.Get("/", func(c fiber.Ctx) error {
return renderIndex(indexTmpl, c, "Fiber")
})
// 따라서 고퍼 이모티콘의 파일 내용을 /gopher.svg에서 서빙한다.
app.Get("/gopher.svg", serveAsset(gopherSVG, "image/svg+xml"))
// 홈의 "Click to see my UUID" 버튼이 여기로 온다.
// 새 UUID를 만들어 /hello/<uuid> 로 리다이렉트하여, URL 경로 퍼라미터로 전달한다.
app.Get("/uuid", func(c fiber.Ctx) error {
return c.Redirect().To("/hello/" + uuid.NewString())
})
// :id 자리에 들어온 경로 퍼라미터를 c.Params로 꺼내서,
// 같은 HTML 폼을 유지한 채 "Hello, Fiber!" 대신 "Hello, <id>!"로 렌더링한다.
app.Get("/hello/:id", func(c fiber.Ctx) error {
return renderIndex(indexTmpl, c, c.Params("id"))
})
// 앱이 3000번 포트에서 듣지 못하면 역시 치명적인 오류로 간주하고 Fatal을 낸다.
log.Fatal(app.Listen(":3000"))
}
여기서도 태그가 <img>가 아닌 <a>일 뿐이지, 비슷한 것이 있습니다. 하지만 src가 아니죠.
<a class="btn" href="/uuid">Click to see my UUID</a>
이것은 버튼을 하나 만들고, Click to see my UUID라는 라벨을 부착하고 나서, http://localhost:3000/uuid를 참조(href)하겠다는 뜻입니다.
그럼 /uuid 엔드포인트에 뭐가 있는지 봐야겠죠.
app.Get("/uuid", func(c fiber.Ctx) error {
return c.Redirect().To("/hello/" + uuid.NewString())
})
이 엔드포인트는 랜덤한 고유 ID(UUID)를 발급한 후, "/hello/생성된UUID"를 참조합니다. 만약 UUID가 e36fdf02-b733-4337-827b-d4010618ef29라면, 접속 주소는 http://localhost:3000/hello/e36fdf02-b733-4337-827b-d4010618ef29가 되는 셈이죠.
이후 이 생성된 UUID는 어떻게 받아 올까요?
// :id 자리에 들어온 경로 퍼라미터를 c.Params로 꺼내서,
// 같은 HTML 폼을 유지한 채 "Hello, Fiber!" 대신 "Hello, <id>!"로 렌더링한다.
app.Get("/hello/:id", func(c fiber.Ctx) error {
return renderIndex(indexTmpl, c, c.Params("id"))
})
이것처럼 UUID를 id라는 이름으로 받아 오고 싶으면, 콜론(:)을 붙여서 :id 꼴로 만들어서 경로로 작성합니다.
이후 이 소스의 renderIndex 내부 함수에 3번째 인자로, c.Params("id")를 이용해 값을 추출해서 스트링으로 주입해 줍니다.
// index.html 템플릿을 data로 렌더링해서 보낸다.
// html/template이 값을 자동으로 이스케이프하므로 퍼라미터에 HTML이 섞여 와도 안전하다.
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})
}
이 주입은 붕어빵 틀처럼 서식이 지정된 일부만 바꿔서 재활용할 수 있는 UI 템플릿(제대로 말하자면 HTML 템플릿)을 첫 번째 인자로 받고, 애플리케이션에 대한 맥락을 저장하거나 불러오는 fiber.Ctx를 두 번째로 받은 후, 맥락 안에 틀과 붕어빵 재료 name을 넣어서 찍어내는 꼴입니다.
저 익명 구조체에서 주입한 Name이라는 구조체 멤버는 HTML 템플릿에서 이렇게 사용됩니다.
<h1>Hello, {{.Name}}!</h1>
결과적으로 Name에 랜덤 UUID가 삽입되어 보이는 겁니다.
이 경우에는 UI에서 http://localhost:3000으로 홈페이지 접속 후, Click to see my UUID 버튼을 눌러서 http://localhost:3000/uuid로 접속한 후, http://localhost:3000/hello/e36fdf02-b733-4337-827b-d4010618ef29로 접속(리디렉션)하게 될 것입니다. 홈페이지 접속 이후 시점에서 총 1번의 "리디렉션"이 발생합니다.
구조를 보면, 우리가 수동으로 UUID 대신 아무 스트링이나 넣어도 잘 표시해 줄 겁니다.
저의 경우 해외 포럼에서 사용하는 닉네임 Lee를 임의로 넣어 보겠습니다. 그럼 http://localhost:3000/hello/Lee로 접속해야겠죠.
마치 원래부터 저를 부르려고 만든 것처럼 자연스럽지 않나요? Go로 백엔드 개발을 하다 보면, 이런 패턴을 자주 보게 될 겁니다.
코딩 초심자를 위한 부록
반드시 주소와 포트가 같아야 동일한 오리진(파일 및 정보의 원천)으로 간주됩니다. 만약 다른 서버에서 이미지를 서빙하고, 주소는 4000번이라면 묵시적으로 호출할 수 없습니다.
HTTPS 서버에서 HTTP로 업로드된 파일을 아무 제약 없이 사용할 수 없습니다. CORS를 찾아 보세요.
app.Listen(":3000")이 아닌 app.Listen(":4000")이면 앱 전체가 localhost:4000 주소로 서빙됩니다.
localhost는 공인된 주소가 아닌 "내 컴퓨터"를 의미합니다. 외부에서 접속할 수 없습니다.
물론 실제 프로덕션에서는 에러 반환이 없는 함수를 바로 사용하는 경우가 드물지만, 간단하게 포트를 변경할 수 있는 방식으로는 이런 것이 있습니다.
import 괄호 안에 "strconv"를 추가하고, main.go의 serveAsset 함수 상단에 const PORT = 3000을 입력하고, 하단의 app.Listen 절을
serveURL := ":" + strconv.Itoa(PORT)
log.Fatal(app.Listen(serveURL))
로 바꾸면 포트 변경이 쉽습니다.
Comments
No comments yet.