Go Unixドメインソケット

GoでUnixドメインソケットで待ち受けるWebサーバを作成するには、net/httpパッケージとsyscallパッケージを使用します。以下にサンプルコードを示します。

package main

import (
	"fmt"
	"log"
	"net"
	"net/http"
	"os"
	"syscall"
)

func main() {
	// Unixドメインソケットのパス
	socketPath := "/tmp/my-web-server.sock"

	// Unixドメインソケットのリスナーを作成
	listener, err := net.Listen("unix", socketPath)
	if err != nil {
		log.Fatal(err)
	}
	defer listener.Close()

	fmt.Printf("Listening on %s\n", socketPath)

	// HTTPハンドラの設定 (例: ルートハンドラ)
	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		fmt.Fprintf(w, "Hello, World!\n")
	})

	// HTTPサーバを起動
	err = http.Serve(listener)
	if err != nil {
		log.Fatal(err)
	}
}

コードの説明:

1. package main: Goプログラムのエントリーポイントとなるパッケージを宣言します。
2. import: 必要なパッケージをインポートします。
   • fmt: フォーマットされた入出力を行います。
   • log: ログ出力を行います。
   • net: ネットワーク関連の機能を提供します。
   • net/http: HTTPサーバの機能を提供します。
   • os: オペレーティングシステムとのインタラクションを提供します。
   • syscall: システムコールへのアクセスを提供します。
3. socketPath := "/tmp/my-web-server.sock": Unixドメインソケットのパスを定義します。 /tmpディレクトリは、一時ファイルが格納される一般的な場所です。 このパスは、クライアントが接続する際に使用されます。
4. listener, err := net.Listen("unix", socketPath): net.Listen関数を使用して、指定されたパスでUnixドメインソケットのリスナーを作成します。 "unix"は、Unixドメインソケットを使用することを指定します。 エラーが発生した場合は、log.Fatalでプログラムを終了します。
5. defer listener.Close(): listenerを閉じる処理を、関数終了時に実行するように遅延させます。 これにより、プログラム終了時にリソースが適切に解放されます。
6. fmt.Printf("Listening on %s\n", socketPath): リスニングしているソケットのパスをコンソールに出力します。
7. http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { ... }): HTTPハンドラを設定します。 この例では、ルートパス("/")へのリクエストに対して、“Hello, World!“を返すハンドラを設定しています。 http.HandleFuncは、指定されたパスとハンドラ関数を関連付けます。
8. err = http.Serve(listener): HTTPサーバを起動し、listenerで待ち受けます。 http.Serveは、クライアントからの接続を受け付け、ハンドラ関数を実行します。 エラーが発生した場合は、log.Fatalでプログラムを終了します。

実行方法:

1. 上記のコードをmain.goなどのファイルに保存します。
2. ターミナルで、ファイルが保存されているディレクトリに移動します。
3. go run main.goコマンドを実行します。

クライアントからの接続:

クライアントは、net/httpパッケージのDial関数を使用して、Unixドメインソケットに接続できます。 例えば、curlコマンドを使用すると、次のように接続できます。

curl -v --unix-socket /tmp/my-web-server.sock http://localhost/

注意点:

• パーミッション: Unixドメインソケットのパーミッションは、クライアントが接続できるように適切に設定する必要があります。 通常は、chmod 777 /tmp/my-web-server.sockのようなコマンドでパーミッションを変更します。 ただし、セキュリティ上の理由から、必要最小限のパーミッションに設定することをお勧めします。
• セキュリティ: Unixドメインソケットは、ローカルネットワークでのみアクセス可能であるため、セキュリティ上のリスクは比較的低いですが、それでも注意が必要です。 特に、ソケットのパスを公開したり、不要なパーミッションを与えたりしないように注意してください。
• エラー処理: 上記のコードは、エラー処理を簡略化するために、log.Fatalを使用しています。 本番環境では、より詳細なエラー処理を行うことをお勧めします。
• ソケットの削除: プログラムを停止した後、ソケットファイルは残ります。 不要になった場合は、rm /tmp/my-web-server.sockコマンドで削除してください。

このサンプルコードは、Unixドメインソケットで待ち受けるWebサーバを作成するための基本的な例です。 必要に応じて、ハンドラ関数をカスタマイズしたり、他の機能を追加したりすることができます。

ご指摘ありがとうございます。ごもっともです。

上記のコード例では、syscallパッケージを直接使用していません。net/httpパッケージとnetパッケージが、Unixドメインソケットの作成とHTTPサーバの起動に必要な機能を内部的に提供しています。

syscallパッケージは、通常、より低レベルなシステムコールを直接呼び出す必要がある場合に利用されます。例えば、ソケットのオプションを設定したり、より詳細なエラー情報を取得したりする場合などです。

今回の例では、net/httpパッケージとnetパッケージの機能で十分であり、syscallパッケージを使用する必要はありませんでした。

ご指摘いただいた通り、コード例からimport "syscall"の行を削除しても、プログラムの動作には影響しません。

混乱させてしまい申し訳ありませんでした。

どういたしまして！お役に立てて嬉しいです。

もし他にGo言語やネットワークプログラミングについて質問があれば、遠慮なく聞いてください。