Home Assistant Community Add-on: FRP Client
You can leverage this add-on to achieve remote access to local Home Assistant OS by port forwarding.
![](https://private-user-images.githubusercontent.com/5491423/295109192-58b8770e-dca5-4353-af27-e45494f78278.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTEwOTE5Mi01OGI4NzcwZS1kY2E1LTQzNTMtYWYyNy1lNDU0OTRmNzgyNzgucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9OTNjNWI1ODZmNTVhMWNkOTM4NzI5MmQ1MzNhYmE3ZmYxMGM4ZWRiZWYwMDcyZTY2MDU3YWMzMjFkNGNjZGM1OCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.u-J9T4KgTm1xvQyLpb_ifb_w0oehu6a76KAV_AfvOhk)
- Go to Settings -> Add-ons -> Add-on Store (bottom right)
- Click Repositories (top right)
![](https://private-user-images.githubusercontent.com/5491423/295110798-699fac45-2b53-4213-811e-5fd0c4362b3b.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTExMDc5OC02OTlmYWM0NS0yYjUzLTQyMTMtODExZS01ZmQwYzQzNjJiM2IucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9ODcxMjc2MGMyMjM2ZjBkMWQ2NmEyMWU0NDdlY2NiYzdlMDU3NzIwZWI4OGEyYzk1YmU0ZTgxNTM4NWVhNmQ4ZiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.IOwBq0sC-CyHBuAow_CCXyDRoU9Bo3yaAyfgTj1cQkE)
- Add the current repository
https://github.com/huxiaoxu2019/hass-addon-frp-client/
![](https://private-user-images.githubusercontent.com/5491423/295111366-91e886d5-dc3b-40a3-951a-9295687cf3f7.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTExMTM2Ni05MWU4ODZkNS1kYzNiLTQwYTMtOTUxYS05Mjk1Njg3Y2YzZjcucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NThjNTE1YmUxODZiNTZjMDIyNmU2ZDc0NjFhN2Q1NjUzMTIxYTQ0NDMwMDc5YmM3Mjg4ZWM4YTRmZTI5YjA3OCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.YWT8lZ9-PWqKf4a3uR_bkiFDhbA-pjE2sizzxq1Dbdo)
- Wait and refresh the Add-on Store page, then you can see one new add-on
Frp Client
, click it and install
![](https://private-user-images.githubusercontent.com/5491423/295116511-0bad82a7-f535-46b1-acf6-1a4151fb6420.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTExNjUxMS0wYmFkODJhNy1mNTM1LTQ2YjEtYWNmNi0xYTQxNTFmYjY0MjAucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MzA5NWE4NjkzOWY0NDVjYzJkNDU3ZTQ3ODExMmEyMGYxOWI1NjM1ZDI5NzZjZDFhMmY5YTZjNGU4ZjAxZjIxMSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.dp8nxi5ZOjJI_nAZ9LHuFw-WHj3iqNHyeMUOyg6isw4)
![](https://private-user-images.githubusercontent.com/5491423/295116650-c0941c9e-6fff-40ad-8d7b-f89d4b937f92.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTExNjY1MC1jMDk0MWM5ZS02ZmZmLTQwYWQtOGQ3Yi1mODlkNGI5MzdmOTIucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MDk4NjA3NDZlMmNjNDE2M2Y0OWI0NDk1MmQyN2E3NWYwZTAwNDgzNzA4YjFhY2FhZDY0YWY3ZjdkNTUyODk4YiZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.Mut9_MwB_fwEFXFurh0GSBOKhi0iPcGvBsF0WjxKiGE)
![](https://private-user-images.githubusercontent.com/5491423/295140088-bee156da-282a-4831-9803-8e45f4331c2c.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTE0MDA4OC1iZWUxNTZkYS0yODJhLTQ4MzEtOTgwMy04ZTQ1ZjQzMzFjMmMucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9NjQ2MzNjNzIzNjkxNjkzYjgwZjNkZmEyM2U3MGVhYTIxNzUxNmFjMjNmYTYxM2Q2ZGI5ZTgwNWUzMTVlMWMwZSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.m4bEnwlazlfZCuyA_Tkl42zMLJ8uMeKiIE3XiZjReW8)
- Add the configurations shown as below in your
configurations.yaml
with File Editor addon
http:
use_x_forwarded_for: true
trusted_proxies:
- 0.0.0.0/0
It's better to modify the 0.0.0.0/0
to your proxy server IP
![](https://private-user-images.githubusercontent.com/5491423/313071952-47c4e863-1481-486a-9acb-41019c388fde.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzMxMzA3MTk1Mi00N2M0ZTg2My0xNDgxLTQ4NmEtOWFjYi00MTAxOWMzODhmZGUucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9YmIxMjUwYjU4MzEzNGFlYTZhY2Q5Y2ZhYmY2YTU2NjAxNjUyOTAzZTU5NTJmYWQ4MmMzZjk0ZGMwMGE1NWRhOCZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.QJ0OJO2C3mM74oYc23xqSME9lnXeN487w_t4-82LKDk)
Notes for Chinese Users: If the above steps fail, please try again as GitHub resource access may be unstable. If the issue persists, you can check the specific logs for troubleshooting by using the command ha su logs
.
![](https://private-user-images.githubusercontent.com/5491423/295225178-d1f0820b-d0c4-450b-b476-cdae386b7e5d.png?jwt=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3MjU4MjY3MTEsIm5iZiI6MTcyNTgyNjQxMSwicGF0aCI6Ii81NDkxNDIzLzI5NTIyNTE3OC1kMWYwODIwYi1kMGM0LTQ1MGItYjQ3Ni1jZGFlMzg2YjdlNWQucG5nP1gtQW16LUFsZ29yaXRobT1BV1M0LUhNQUMtU0hBMjU2JlgtQW16LUNyZWRlbnRpYWw9QUtJQVZDT0RZTFNBNTNQUUs0WkElMkYyMDI0MDkwOCUyRnVzLWVhc3QtMSUyRnMzJTJGYXdzNF9yZXF1ZXN0JlgtQW16LURhdGU9MjAyNDA5MDhUMjAxMzMxWiZYLUFtei1FeHBpcmVzPTMwMCZYLUFtei1TaWduYXR1cmU9MGY3YWJhNmM1MWZkY2MwNzI4ODQ2NjkwMmMxNTQ3ZDliODE0MDMyZjJkYmEyM2I3ZGRhMTk2YWE1NTM2NGUzZSZYLUFtei1TaWduZWRIZWFkZXJzPWhvc3QmYWN0b3JfaWQ9MCZrZXlfaWQ9MCZyZXBvX2lkPTAifQ.fICbmC5vy78-TUBSHm7rZgEjIli5jVrTMbl0Mdr7Jug)
Welcome and appreciate contributions from the Home Assistant community. If you have ideas for improvements, bug fixes, or new features, feel free to contribute by submitting a pull request (PR). Before you start, please make sure to follow these guidelines:
If you encounter any bugs or have ideas for new features, please open an issue on the issue tracker.
- Clearly describe the purpose of your changes in the pull request
- Provide step-by-step instructions for testing your changes
- Ensure that your changes do not introduce new issues
Please note that this project follows Home Assistant's Code of Conduct. Be respectful and considerate in all interactions.
Xiaoxu Hu [email protected]
Special thanks to: @steplov for the setup script