setup-ipsec-vpn/azure/README.md

[English](README.md) | [中文](README-zh.md)

# Deploy to Microsoft Azure

This template will create a fully working VPN server on the Microsoft Azure Cloud ([pricing details](https://azure.microsoft.com/en-us/pricing/details/virtual-machines/)).

Customizable with the following options:

 - Username for VPN **and** SSH
 - Password for VPN **and** SSH
 - IPsec Pre-Shared Key for VPN
 - Operating System Image (Ubuntu 22.04 or 20.04)
 - Virtual Machine Size (Default: Standard_B1s)

**Note:** DO NOT use these special characters within values: `\ " '`

Press this button to start:

[![Deploy to Azure](../docs/images/azure-deploy-button.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fhwdsl2%2Fsetup-ipsec-vpn%2Fmaster%2Fazure%2Fazuredeploy.json)

When the deployment finishes, Azure displays a notification. Next steps: [Configure VPN Clients](../README.md#next-steps).

**Note:** When connecting to the server using SSH, use the username and password you specified in the deployment template. To add or export IKEv2 clients, run `sudo ikev2.sh`. If somehow you still cannot SSH into the VM after entering the correct login credentials, see [Troubleshoot SSH connections to an Azure Linux VM that fails, errors out, or is refused](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-connection) and/or [Can't SSH to Azure Linux VM because permissions are too open](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-permissions-too-open).

## Authors

Copyright (C) 2016 [Daniel Falkner](https://github.com/derdanu)   
Copyright (C) 2017-2024 [Lin Song](https://github.com/hwdsl2)

## Screenshot

<details>
<summary>
Click to see screenshot.
</summary>

![Azure Custom Deployment](custom_deployment_screenshot.png)
</details>
Update docs 2022-07-29 06:55:47 +02:00			`[English](README.md) \| [中文](README-zh.md)`
Update README.md [ci skip] 2016-08-11 05:15:11 +02:00
Update docs 2022-07-29 06:55:47 +02:00			`# Deploy to Microsoft Azure`
Update README.md [ci skip] 2016-08-11 05:15:11 +02:00
Update docs 2021-06-05 00:27:21 +02:00			`This template will create a fully working VPN server on the Microsoft Azure Cloud ([pricing details](https://azure.microsoft.com/en-us/pricing/details/virtual-machines/)).`
Update README.md [ci skip] 2016-08-11 05:15:11 +02:00
			`Customizable with the following options:`

Update docs 2020-05-04 05:12:17 +02:00			`- Username for VPN and SSH`
			`- Password for VPN and SSH`
Fix Azure template - Switch to version 2 of the Azure Custom Script Extension - Use default VM size "Basic_A0" for deployments (configurable) - Clean up install.sh, and other minor improvements 2017-05-31 21:13:54 +02:00			`- IPsec Pre-Shared Key for VPN`
Update docs 2023-05-05 07:15:09 +02:00			`- Operating System Image (Ubuntu 22.04 or 20.04)`
Update Azure template - Use Debian 9 instead of Debian 8 - Update Virtual Machine size options - Add wait for apt/dpkg lock in install.sh 2018-05-10 09:57:08 +02:00			`- Virtual Machine Size (Default: Standard_B1s)`
Update README.md [ci skip] 2016-08-11 05:15:11 +02:00
Fix Azure deploy - Fix handling of special characters in the Azure deployment config by quoting the VPN parameters - Fixes #644. Thanks @turbozapekanka for the report! 2019-11-02 05:34:56 +01:00			Note: DO NOT use these special characters within values: `\ " '`

Update README.md [ci skip] 2016-08-11 05:15:11 +02:00			`Press this button to start:`

Update docs 2021-06-05 00:27:21 +02:00			`[![Deploy to Azure](../docs/images/azure-deploy-button.png)](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Fhwdsl2%2Fsetup-ipsec-vpn%2Fmaster%2Fazure%2Fazuredeploy.json)`
Update docs 2017-06-12 09:29:53 +02:00
Update Azure config - Add Ubuntu 20.04 to OS options, and set as default 2020-08-29 07:01:05 +02:00			`When the deployment finishes, Azure displays a notification. Next steps: [Configure VPN Clients](../README.md#next-steps).`
Update README.md [ci skip] 2016-08-11 05:15:11 +02:00
Update docs - Ref: #1145 2022-04-06 06:06:01 +02:00			Note: When connecting to the server using SSH, use the username and password you specified in the deployment template. To add or export IKEv2 clients, run `sudo ikev2.sh`. If somehow you still cannot SSH into the VM after entering the correct login credentials, see [Troubleshoot SSH connections to an Azure Linux VM that fails, errors out, or is refused](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-connection) and/or [Can't SSH to Azure Linux VM because permissions are too open](https://docs.microsoft.com/en-us/troubleshoot/azure/virtual-machines/troubleshoot-ssh-permissions-too-open).
Update docs 2022-02-27 01:12:47 +01:00
Fix Azure template - Switch to version 2 of the Azure Custom Script Extension - Use default VM size "Basic_A0" for deployments (configurable) - Clean up install.sh, and other minor improvements 2017-05-31 21:13:54 +02:00			`## Authors`
Update README.md [ci skip] 2016-08-11 05:15:11 +02:00
Update docs 2017-06-12 09:29:53 +02:00			`Copyright (C) 2016 [Daniel Falkner](https://github.com/derdanu)`
Update year 2024-02-03 22:31:58 +01:00			`Copyright (C) 2017-2024 [Lin Song](https://github.com/hwdsl2)`
Update docs [ci skip] 2016-12-22 17:27:56 +01:00
			`## Screenshot`

Update Azure template - Add Ubuntu 22.04 and set as default 2022-05-04 05:28:04 +02:00			`<details>`
			`<summary>`
			`Click to see screenshot.`
			`</summary>`

Update docs [ci skip] 2016-12-22 17:27:56 +01:00			`![Azure Custom Deployment](custom_deployment_screenshot.png)`
Update Azure template - Add Ubuntu 22.04 and set as default 2022-05-04 05:28:04 +02:00			`</details>`