ps3netsrv-go

It's an alternative implementation of original ps3netsrv which needed to install games using WebMAN/IrisMAN over network (without copying files to console).

I made it because original code is way hard to read and hard to build for some platforms. And for fun and education (understanding and implementation custom network protocols, generating/serving iso image on-the-fly) of course.

This project written in Go because it's (cross-)compilation is much easier than C/C++ and resulting binaries will run without any external library on target system.

Currently multipart files are not supported. But I've added tcp data exchange timeouts to reduce amount of "hang" connections.

Receiving files from console is supported now! Use flag --allow-write to enable this.

Decryption of 3k3y/redump images on-the-fly is supported now! Keys search behaviour completely matches with original ps3netsrv: at first we try to find .dkey file for .iso in PS3ISO directory. Then we try to find .dkey in REDKEY directory. You can also use

$ ps3netsrv-go decrypt

tool to decrypt images.

Running

Just run

$ ps3netsrv-go server

from your working directory to serve it.

Or specify custom root directory in --root flag of server subcommand:

$ ps3netsrv-go server --root=/home/user/games

To get help run:

$ ps3netsrv-go --help

To run "debug" server (for pprof, etc.) specify --debug-server-listen-addr flag.

Configuration

Server supports configuration via environment variables and command line flags. Environment variables names can be found in output of ps3netsrv-go server --help command. I.e. in line:

--root="."                             Root directory with games ($PS3NETSRV_ROOT).

PS3NETSRV_ROOT is environment variable name.

Also server supports configuration via config file. Example:

[server]
root = /home/user/games
client-whitelist = 192.168.1.0/24
max-clients = 10
allow-write = true

Configuration keys names are the same as command line flags names without -- prefix.

Config file discovered in following order:

• --config flag or PS3NETSRV_CONFIG_FILE environment variable
• config.ini file in current directory
• <user config directory>/ps3netsrv-go/config.ini, where <user config directory> is OS-specific directory for user configuration files:
  • %APPDATA% on Windows
  • $XDG_CONFIG_HOME or ~/.config on Linux
  • ~/Library/Application Support on macOS

Performance tips

• Connect your console to the network using ethernet cable. To achieve maximum performance server and console should be connected with 1Gbps network.
• Use SSD or NVMe drive to store games. It will reduce loading times.
• Use decrypted ISOs. It will reduce CPU usage and loading times. You can decrypt images using decrypt subcommand.
• Use "compiled" ISOs instead of folder with files. It will reduce loading times. You can build ISO image using makeiso subcommand.

Exposing tips

• Use limits:
  • by IP address(es) using --client-whitelist flag: $ ps3netsrv-go server --root=/home/games --client-whitelist=192.168.0.123
  • by number of clients using --max-clients flag
  • idle connection time: --read-timeout flag
• To expose over NAT (non-public or "grey" IP) you can use:
  • ngrok TCP tunnels
  • Reverse SSH tunnel to host with public IP
  • any other options
• To secure connection using TLS you may use two TLS-terminators (like HAProxy) configured with mutual TLS authentication. Note that desired terminator must support "wrapping" plain TCP connection to TLS with client certificate.

Requirements to build

Go 1.23+

Building

$ go mod download
$ go build -o ps3netsrv-go ./cmd/ps3netsrv-go/...