Go入門:小さなWebサーバーを作って動かす手順

Go入門:小さなWebサーバーを作って動かす手順 Go

こんにちは!ともです。「Webサーバーって、大きな仕組みがないと作れないのでは」と思っていませんか。言語によっては、その言語に最初から入っている道具だけで、小さなサーバーなら意外とあっさり作れます。

この記事で使うのは、Go(ゴー)という言語です。題材は、ブラウザでアクセスすると挨拶と現在時刻を返す、小さなWebサーバーです。追加の部品は使わず、Goの標準ライブラリだけで作ります。

この記事で分かること

この記事で分かること
この記事で分かること
  • 完成品で何ができるようになるか
  • 必要なものとコスト(無料で使える範囲)
  • Goのインストールと動作確認の手順
  • プロジェクトの初期化(go mod init)から実行(go run)までの流れ
  • 挨拶と現在時刻を返すサーバーのコードの骨格
  • 実行ファイルにまとめる方法(go build)

完成品のイメージ:ブラウザに挨拶と時刻が表示される

完成品のイメージ:ブラウザに挨拶と時刻が表示される
完成品のイメージ:ブラウザに挨拶と時刻が表示される

完成すると、自分のパソコンの中でWebサーバーが動き出します。ブラウザで決まった住所(URL)を開くと、「こんにちは!ともです。」という挨拶と、その時点の現在時刻が表示されます。

ページを再読み込みすると、時刻の表示が新しい時刻に変わります。「サーバーがアクセスを受けるたびに、その場で文章を組み立てて返している」ことが体感できる題材です。

Goの特徴として、コンパイル(実行できる形への変換)が速いことと、出来上がったプログラムが単一の実行ファイルになることが挙げられます。作った道具をファイル1つで配れる形にできる、という点も、この記事の最後で確認します。

必要なものとコスト

必要なものとコスト
必要なものとコスト

Goは公式に無料で配布されている言語です。標準ライブラリだけで作る範囲では、追加の料金はかかりません。

項目内容
使うツールGo本体(公式配布)/VS Codeなどのエディタ/ブラウザ
料金の目安無料(約0円)。Go本体は公式サイトからダウンロードして使う
前提パソコンの基本操作。プログラミングの経験はなくて大丈夫

サーバーといっても、今回は自分のパソコンの中だけで動かすものです。外部へ公開するものではないため、サーバーのレンタル料なども発生しません。料金の目安は2026年11月確認時点のものです。

難易度と進め方の目安

難易度と進め方の目安
難易度と進め方の目安

難易度は低めから中くらいです。Goは書き方の決まりが少なく、標準ライブラリにWebサーバーの機能が最初から入っているため、サーバー作りの入門題材として扱いやすい言語です。

目安の所要時間は、Goのインストール込みで1時間前後です。進め方は「Goのインストール→動作確認→プロジェクトの初期化→コードを書く→実行してブラウザで確認→実行ファイルにまとめる」の順番です。

コードを書くエディタは、VS Codeがあると作業がしやすくなります。

VS Codeのインストールと初期設定

インストール・初期設定

インストール・初期設定
インストール・初期設定

まず、Goをインストールします。入手先は公式サイト(go.dev)です。トップページのダウンロード案内から、自分のパソコン(Windows/Mac)向けのインストーラを取得してください。

手順は次のとおりです。

  1. 公式サイトからインストーラをダウンロードする
  2. インストーラを実行し、案内に沿ってインストールを進める
  3. ターミナルを開いて、バージョン確認のコマンドを実行する

確認のコマンドは次の1つです。バージョン番号が表示されれば、用意はできています。

# Goのバージョンを表示する(表示されればインストール完了)
go version

次に、作業用のフォルダを作り、そのフォルダをGoのプロジェクトとして初期化します。この初期化で作られる「go.mod」というファイルが、プロジェクトの目印になります。

# 作業用のフォルダを作って、その中へ移動する
mkdir go-server
cd go-server

# このフォルダをGoのプロジェクトとして初期化する(go.modが作られる)
go mod init example.com/goserver

「example.com/goserver」の部分は、プロジェクトに付ける名前です。自分のプロジェクトでは、区別がつく名前であれば構いません。この初期化を済ませてから、コードを書くファイル「main.go」をフォルダの中に用意します。

作り方の骨格1:挨拶と現在時刻を返すサーバーを書く

作り方の骨格1:挨拶と現在時刻を返すサーバーを書く
作り方の骨格1:挨拶と現在時刻を返すサーバーを書く

コードを書きます。ファイル名は「main.go」です。使うのは、Goに最初から入っている標準ライブラリだけです。

// アクセスすると挨拶と現在時刻を返す、小さなWebサーバー
package main

// 必要な道具(標準ライブラリ)を読み込む
import (
    "fmt"      // 画面やブラウザへ文字を書き出すための道具
    "net/http" // Webサーバーを動かすための道具
    "time"     // 現在時刻を取得するための道具
)

// アクセスが来たときに呼ばれる処理
func helloHandler(w http.ResponseWriter, r *http.Request) {
    // 今の日時を取得する
    now := time.Now()

    // 挨拶と現在時刻を、ブラウザへ返す文章として書き出す
    fmt.Fprintf(w, "こんにちは!ともです。\n現在の時刻は %s です。", now.Format("2006年1月2日 15時04分05秒"))
}

// プログラムの入口(実行はここの main 関数から始まる)
func main() {
    // 「/」という住所へのアクセスを、上の処理に割り当てる
    http.HandleFunc("/", helloHandler)

    // 起動したことをターミナルに表示する
    fmt.Println("サーバーを起動しました: http://localhost:8080")

    // 8080番の入口(ポート)で、アクセスの待ち受けを始める
    err := http.ListenAndServe(":8080", nil)

    // 待ち受けに失敗した場合は、理由を表示する
    if err != nil {
        fmt.Println("起動に失敗しました:", err)
    }
}

ポイントは3つです。1つ目は、アクセスへの対応を「住所(パス)」と「処理(関数)」の組み合わせで割り当てる形です。この記事では「/」へのアクセスを、挨拶を返す処理に割り当てています。

2つ目は、時刻の扱いです。サーバーはアクセスを受けるたびに処理を動かすため、time.Now() でその時点の時刻を取り直します。再読み込みするたびに表示が変わるのは、このためです。

3つ目は、時刻の整形(Format)で使う並びが「2006年1月2日…」という独特の形をしている点です。Goでは、基準となる決まった日時を並べることで、表示の形を指定します。最初は戸惑いますが、決まりごととしてそのまま使ってください。

作り方の骨格2:実行して確認し、実行ファイルにまとめる

作り方の骨格2:実行して確認し、実行ファイルにまとめる
作り方の骨格2:実行して確認し、実行ファイルにまとめる

コードが書けたら、ターミナルから実行します。実行中はサーバーが動き続けるため、確認用のコマンドは別のターミナルを開いて実行してください。

# プログラムを実行する(コンパイルと実行をまとめて行う。止めるときは Ctrl+C)
go run .

# 別のターミナルで、サーバーへアクセスして返事を確認する
curl http://localhost:8080

ターミナルに挨拶と時刻が返ってきたら、サーバーは動いています。ブラウザで「http://localhost:8080」を開いても、同じ内容が表示されます。再読み込みして、時刻が新しくなっていることも確認してみてください。

最後に、実行ファイルへのまとめ方です。go build を使うと、プログラムが単一の実行ファイルになります。

# 実行ファイルにまとめる(go-server というファイルができる。Windowsでは go-server.exe)
go build -o go-server .

# まとめた実行ファイルを、直接起動する(Windowsでは go-server.exe)
./go-server

実行ファイルが1つあれば、Goをインストールしていない環境でも同じプログラムを動かせます(動作する対象のパソコンの種類に合わせて作る必要があります)。「ファイル1つで配れる」手軽さは、Goで小さな道具を作るときの強みです。

先にコマンドラインで動く道具の作例も読んでおくと、「実行してすぐ終わる道具」と「動き続けるサーバー」の違いが整理できます。

Java入門:コマンドラインで動く小さな道具を作る手順

つまずきやすい点

つまずきやすい点
つまずきやすい点

よくあるつまずきは5つです。1つ目は、「go.mod が見つからない」というエラーです。go run はプロジェクトの中で実行する前提のため、先にフォルダを作り、go mod init で初期化してから実行してください。

2つ目は、「address already in use(住所が使用中)」という起動エラーです。8080番の入口を、別のプログラムがすでに使っている状態です。先に動いているサーバーを止めるか、コード内の番号を「:8081」のような別の番号に変えてください。

3つ目は、ブラウザで開いても何も表示されないケースです。サーバーが起動しているか(ターミナルに起動の表示が出ているか)と、ブラウザで開いた住所の番号が、コードで指定した番号と合っているかを、この順番で確認してください。

4つ目は、コードを直したのに表示が変わらないケースです。動いているサーバーは、起動時点のコードで動いています。go run を一度止めて(Ctrl+C)から実行し直すと、新しいコードで動き直します。

5つ目は、読み込んだのに使っていない道具(import)があるとエラーになる点です。Goでは、宣言したのに使っていないものをエラーとして知らせる決まりがあります。書きかけの段階では、使っていない読み込みの行を一時的に消して進めてください。

まとめ

まとめ
まとめ

Goの入門は、「公式からインストールする→go mod initでプロジェクトを用意する→標準ライブラリで処理を書く→go runで実行する→go buildで実行ファイルにまとめる」という流れで進みます。部品を追加しなくても、サーバーの基本形までたどり着けるのがGoの進め方です。

言語そのものの選び方を整理したい場合は、言語の種類と目的別の選び方をまとめた記事もあわせてどうぞ。

プログラミング言語とは何か

なお、「自分で作るのではなく、業務の自動化そのものを相談したい」という場合は、作ってもらう選択肢もあります。

\ 業務の自動化やAI活用を、代わりに作ってほしい方はこちら /

コメント

タイトルとURLをコピーしました