[GH-ISSUE #1892] How to install on Linux? #1499

Closed
opened 2026-05-05 12:56:51 -06:00 by gitea-mirror · 8 comments
Owner

Originally created by @amir0ff on GitHub (Jul 7, 2020).
Original GitHub issue: https://github.com/fatedier/frp/issues/1892

There's no info whatsoever on how to build and install this on Ubuntu for example...

what are these supposed to mean:

./frps -c ./frps.ini

how to build and run this tunnel server?

Originally created by @amir0ff on GitHub (Jul 7, 2020). Original GitHub issue: https://github.com/fatedier/frp/issues/1892 There's no info whatsoever on how to build and install this on Ubuntu for example... what are these supposed to mean: `./frps -c ./frps.ini` how to build and run this tunnel server?
Author
Owner

@fatedier commented on GitHub (Jul 7, 2020):

You can download binary files from release page https://github.com/fatedier/frp/releases.

Or just exeute make to build like other golang projects.

<!-- gh-comment-id:654676564 --> @fatedier commented on GitHub (Jul 7, 2020): You can download binary files from release page https://github.com/fatedier/frp/releases. Or just exeute `make` to build like other golang projects.
Author
Owner

@amir0ff commented on GitHub (Jul 7, 2020):

You can download binary files from release page https://github.com/fatedier/frp/releases.

Or just exeute make to build like other golang projects.

aren't there any prerequisites for building a goland project? say on a Ubuntu server 20.04 for example?

because out of the box I receive this

ubuntu@192.168.1.10:/home/frp# make
go fmt ./...
make: go: Command not found
Makefile:19: recipe for target 'fmt' failed
make: *** [fmt] Error 127
ubuntu@192.168.1.10:/home/frp#

<!-- gh-comment-id:654716881 --> @amir0ff commented on GitHub (Jul 7, 2020): > You can download binary files from release page https://github.com/fatedier/frp/releases. > > Or just exeute `make` to build like other golang projects. aren't there any prerequisites for building a goland project? say on a Ubuntu server 20.04 for example? because out of the box I receive this `ubuntu@192.168.1.10:/home/frp# make ` `go fmt ./... ` `make: go: Command not found ` `Makefile:19: recipe for target 'fmt' failed ` `make: *** [fmt] Error 127 ` `ubuntu@192.168.1.10:/home/frp# `
Author
Owner

@alterhu2020 commented on GitHub (Jul 28, 2020):

linux is a bit same as other platform, https://code.pingbook.top/blog/setup/frp-linux-setup.html

<!-- gh-comment-id:664731536 --> @alterhu2020 commented on GitHub (Jul 28, 2020): linux is a bit same as other platform, https://code.pingbook.top/blog/setup/frp-linux-setup.html
Author
Owner

@amir0ff commented on GitHub (Jul 28, 2020):

linux is a bit same as other platform, https://code.pingbook.top/blog/setup/frp-linux-setup.html

I see many examples like setting logs that are missing from the docs of this repository. The link you sent is in Chinese. Is there any documentation in English? with all the API?

<!-- gh-comment-id:664802006 --> @amir0ff commented on GitHub (Jul 28, 2020): > linux is a bit same as other platform, https://code.pingbook.top/blog/setup/frp-linux-setup.html I see many examples like setting logs that are missing from the docs of this repository. The link you sent is in Chinese. Is there any documentation in English? with all the API?
Author
Owner
<!-- gh-comment-id:664880706 --> @fatedier commented on GitHub (Jul 28, 2020): https://github.com/fatedier/frp#example-usage https://github.com/fatedier/frp/blob/master/conf/frpc_full.ini https://github.com/fatedier/frp/blob/master/conf/frps_full.ini @amiroff157 Try these documents.
Author
Owner

@amir0ff commented on GitHub (Jul 28, 2020):

https://github.com/fatedier/frp#example-usage

@amiroff157 Try this documents.

Any examples on how logging work? I can't find any

For example:

log_file = ?
log_level = ?
log_max_days = ?
token = ?

I want to know how these work

<!-- gh-comment-id:664884738 --> @amir0ff commented on GitHub (Jul 28, 2020): > https://github.com/fatedier/frp#example-usage > > @amiroff157 Try this documents. Any examples on how logging work? I can't find any For example: log_file = ? log_level = ? log_max_days = ? token = ? I want to know how these work
Author
Owner

@antonioribeiro commented on GitHub (Aug 4, 2025):

frp quick install guide (ubuntu + macOS)

install go

apt-get install golang

clone the repo

git clone https://github.com/fatedier/frp.git
cd frp

compile it

make

put your frps.toml file on the server

## frps.toml
bindPort = 7000

then run it

./bin/frps -c ./frps.toml

you should see something like this

2025-08-04 09:36:04.499 [I] [frps/root.go:108] frps uses config file: ./frps.toml
2025-08-04 09:36:04.656 [I] [server/service.go:237] frps tcp listen on 0.0.0.0:7000
2025-08-04 09:36:04.656 [I] [frps/root.go:117] frps started successfully

install the client on macOS

brew install fprc

put your frpc.toml file on the client

## frpc.toml
serverAddr = "x.x.x.x"
serverPort = 7000

[[proxies]]
name = "ssh"
type = "tcp"
localIP = "127.0.0.1"
localPort = 22
remotePort = 6000

you should see something like this

2025-08-04 11:52:57.876 [I] [sub/root.go:149] start frpc service for config file [frpc.toml]
2025-08-04 11:52:57.877 [I] [client/service.go:314] try to connect to server...
2025-08-04 11:52:57.941 [I] [client/service.go:306] [44010f04a487b443] login to server success, get run id [44010f04a487b443]
2025-08-04 11:52:57.941 [I] [proxy/proxy_manager.go:177] [44010f04a487b443] proxy added: [ssh]
2025-08-04 11:52:57.962 [I] [client/control.go:172] [44010f04a487b443] [ssh] start proxy success
<!-- gh-comment-id:3149897255 --> @antonioribeiro commented on GitHub (Aug 4, 2025): # frp quick install guide (ubuntu + macOS) ## install go ``` apt-get install golang ``` ## clone the repo ``` git clone https://github.com/fatedier/frp.git cd frp ``` ## compile it ``` make ``` ## put your frps.toml file on the server ``` ## frps.toml bindPort = 7000 ``` ## then run it ``` ./bin/frps -c ./frps.toml ``` ## you should see something like this ``` 2025-08-04 09:36:04.499 [I] [frps/root.go:108] frps uses config file: ./frps.toml 2025-08-04 09:36:04.656 [I] [server/service.go:237] frps tcp listen on 0.0.0.0:7000 2025-08-04 09:36:04.656 [I] [frps/root.go:117] frps started successfully ``` ## install the client on macOS brew install fprc ## put your frpc.toml file on the client ``` ## frpc.toml serverAddr = "x.x.x.x" serverPort = 7000 [[proxies]] name = "ssh" type = "tcp" localIP = "127.0.0.1" localPort = 22 remotePort = 6000 ``` ## you should see something like this ``` 2025-08-04 11:52:57.876 [I] [sub/root.go:149] start frpc service for config file [frpc.toml] 2025-08-04 11:52:57.877 [I] [client/service.go:314] try to connect to server... 2025-08-04 11:52:57.941 [I] [client/service.go:306] [44010f04a487b443] login to server success, get run id [44010f04a487b443] 2025-08-04 11:52:57.941 [I] [proxy/proxy_manager.go:177] [44010f04a487b443] proxy added: [ssh] 2025-08-04 11:52:57.962 [I] [client/control.go:172] [44010f04a487b443] [ssh] start proxy success ```
Author
Owner

@amir0ff commented on GitHub (Aug 4, 2025):

@antonioribeiro my dude it's been 5 years and already using FRPS on all my servers 😉

<!-- gh-comment-id:3151090315 --> @amir0ff commented on GitHub (Aug 4, 2025): @antonioribeiro my dude it's been 5 years and already using FRPS on all my servers 😉
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: github-starred/frp#1499
No description provided.