File Transfer Protocol (FTP/SFTP)

您所在的位置：网站首页 › wp-content/uploads/2019/05/333.jpg › File Transfer Protocol (FTP/SFTP)

File Transfer Protocol (FTP/SFTP)

2023-07-17 01:11| 来源: 网络整理| 查看: 265

Last updated on November 28th, 2022

migrationsftpWPCore

When hosting your WordPress site on WP Engine, you may need to connect directly to your website’s filesystem. On other platforms you may already be used to using FTP. At WP Engine we use SFTP which works the same, except it uses a layer of encryption for security and is restricted to a secured port.

Most commonly you’ll need SFTP access when migrating your site, performing a partial restore, or while editing/accessing a specific file (such as the wp-config.php file).

Contents hide 1 SFTP Clients 2 Add SFTP User 3 Edit SFTP User 4 Connect to SFTP 5 SFTP Tips 6 Common Issues 7 Update SFTP Host Keys 7.1 Update Host Key 7.2 Delete All Host Keys 7.3 Update known_hosts File 8 Limitations SFTP Clients

Before you can connect to your site’s file system, you’ll need access to a compatible client. While we don’t restrict the programs you can use, but a program may not be compatible. We recommend one of the following clients:

FileZilla – Works on all operating systemsVisual Studio Code – Free visual code editor, compatible with Mac and PC. Make sure you install the SFTP extension.Notepad ++ – Works on PC only but has also has a great live edit mode

While you are free to use the SFTP client of your choice, your SFTP client will need to use one of the following supported ciphers:

aes192-ctraes256-ctr

We do not support the SFTP ciphers: SHA1, aes128-ctr, CBC, RC4, 3DES, MD5, and RIPEMD for security reasons. If your SFTP client uses one of these ciphers, it will not work properly with our platform and instead we recommend using one of the clients listed above.

NOTE

Before connecting, always ensure your client is updated, as this is a common cause of connection issues.

Add SFTP User

Along with an SFTP client you will need SFTP credentials. These are not your wp-admin or User Portal credentials. Each set of SFTP credentials will only work for one environment.

Fill out the following required fields: Username — Your environment name will be appended to this automatically after saving: EX: environmentname-usernamePassword — You can securely generate a random password by clicking the lock icon, or set a password with the following requirements: At least 8 charactersUppercase and lowercase lettersInclude numbers and special charactersOnce the password has been set it cannot be viewed again. If you lose the password, you will have to set a new one. Be sure to copy or write the password down before saving. Path (Optional) — A specific directory to connect to. Defaults to the root (topmost directory) if left blank. Must be a relative path, starting with a forward slash.Do not include HTTP/HTTPS, or your domain.Any subdirectory below the path defined here can also be accessed. Any directory above the path defined cannot be accessed.To restrict a theme developer to all theme directories: /wp-content/themes/To restrict a vendor to media uploads from April 2019: /wp-content/uploads/2019/04/

Environment — Production, Staging, or Development: Refers to the active environment.Click Add SFTP User Edit SFTP User

To edit an existing SFTP user:

Log in to the User PortalSelect the environment you wish to connect toClick SFTP UsersClick on an existing usernameFill in a new password with the following requirements OR hit the lock icon to generate a secure password automatically At least 8 characters Uppercase and lowercase letters Include numbers special characters Click Update User Connect to SFTP

After adding an SFTP user, take note of the SFTP Address and Port Number in your User Portal. The SFTP address is different for every environment.

In this example we’ll be using FileZilla, but the fields should be similar in any client. Fill out the following fields then hit Connect.

Host — SFTP Address

Your environment name plus sftp.wpengine.comEX: mysite.sftp.wpengine.com

NOTE

When using Quick Connect in FileZilla you will need to specify sftp protocol by also adding sftp:// before the hostname. (Shown in example image below.) EX: sftp://environment.sftp.wpengine.com

Username — Username set in the User Portal. Your unique environment name is appended and hyphenated automatically.

Ex: environment-someuser

Password — Password exactly as set previously in the User Portal.

Pay attention to capital letters, spaces, symbols, etc.If you forgot the password it cannot be viewed again after saving. You must edit the SFTP user to set a new password.

Port — Always set to 2222

No other port numbers will work here.

NOTE

You may see a pop-up referring to SSH host keys if you’ve never connected before. Accept any warnings to continue.

SFTP Tips Make a backup before editing any site content.Once you are connected to your site, you will see a directory listing of your computer’s contents on the left. Your remote website directory is on the right.

Double-click a directory name to expand and view the contents.Drag and drop files between locations or directories.If you are replacing a file be sure to accept any prompts to overwrite the existing file or you will not see your changes.Reset file permissions and purge server caches from the WP Engine plugin after making changes.Location quick reference: Theme files: wp-content/themes/Plugin files: wp-content/plugins/Uploads: wp-content/uploads/ Often divided further by year, then month: wp-content/uploads/2019/04 Your SFTP host name and user name will both include the environment name at the beginning. This should make verifying that you’re connecting correctly a little easier.

Common Issues

Error: Cannot establish FTP connection to an SFTP server. Please select proper protocol.

Ensure you have set your client to connect using SFTP protocol.This may be a dropdown to select SFTP, or you may have to preface your hostname field with sftp:// EX: sftp://mysite.wpengine.com Ensure you are using the correct port. Only port 2222 is supported.

Error: Authentication failed.

The user name or password is wrong.Change your password or try adding a completely new user.

I’m being prompted to update my SSH host keys. I hit “accept”, but still can’t connect.

During security updates our server host keys can change. You may need to delete your existing SSH host keys first before new ones can be properly accepted by your SFTP client.

Still unable to connect with SFTP?

Restart your FTP client completelyTry connecting with a different clientEnsure your client is up to dateVerify the path you’re connecting to exists as a directory on your website, or reset the path to default completelyCreate a different SFTP userTry to connect to any other environments on your account with SFTPContact our Support team

I connected without an error, but my remote directory and file listing is blank.

Check the path your user is configured for. Does it exist? Is it spelled right?We recommend resetting this to default (blank) and trying again.

I’m not seeing changes on my site after uploading a file.

Reset file permissionsPurge server cachesPurge local caches

Still not seeing your changes?

If you modified a theme/plugin file, ensure you have the correct theme/plugin name activatedAdd a comment to the top of your file and upload it againTry opening your file in the browser directly- Do you see your comment or code changes? EX: http://mydomain.com/wp-content/uploads/test.txt Try uploading a test TXT file to the same directory, then see if you can load that file in your browser directly. Can you view this test file?

If you can see changes in the files when viewed directly but not on the website, it is most likely a caching issue.

Try purging local and server caches againYou may even need to restart your computerTest again on a mobile device, disconnected from WiFi

If you can’t see any changes when directly viewing files you’ve added, it’s most likely an SFTP connection issue.

Check the host name, username, password and port.Verify you’re uploading to the correct directoryConfirm the file name spelling and capitalization Update SFTP Host Keys

If when using your SFTP client on WP Engine, you receive a warning that your “host keys do not match” or “host key changed”, you will need to update host keys stored on your local machine. There are three options to update your host keys.

Update Host Key

Option one in this scenario is to manually update your host key. This method generates the new host key and connects you to your host: environment.sftp.wpengine.com. This is the easiest, recommended method. Please keep in mind these steps need to be taken on the local computer where you are experiencing this issue.

Run the following command in a local Mac/Linux Terminal window, where environment is the name of your WP Engine environment:

cd ~/.sshssh-keygen -R environment.sftp.wpengine.com:2222 Delete All Host Keys

Option two in this scenario is to delete the host key entry for your host: environment.sftp.wpengine.com

Mac/Linux

To delete your local host key, you just need to remove your known_hosts file. Open terminal and run the following commands:

cd ~/.sshrm known_hosts

Windows

To update your local host key on a Windows machine, open up PuTTY and perform the following steps:

Open up regedit.exe by doing a searchNavigate to HKEY_CURRENT_USERSoftwareSimonTathamPuTTYSshHostKeysDelete all keys listed Update known_hosts File

Similar to removing removing all known hosts in Option two, this option removes just one known host.

The warning message your SFTP client shows will usually list the line in known_hosts that is triggering this message, so be sure to make a note of this.

Mac/Linux

On Mac/Linux you can simply edit the file using vi, which is a text editor. Run the following commands. Be sure to update 100 to the line number your error message displays.

cd ~/.sshvi known_hosts +100

Once the file opens to this line:

Type the key d twice to remove the lineType :x to save.

Windows

On a Windows machine using PuTTY, go to the Registry folder just like in step two. In that directory, a list of hostnames appears. Right click on the environment.sftp.wpengine.com one, and then select Delete.

Limitations

We do not support the SFTP ciphers SHA1, aes128-ctr, CBC, RC4, 3DES, MD5, and RIPEMD for security reasons. If your SFTP client uses one of these ciphers, it may not work properly with our platform. We suggest reaching out to your SFTP software maker to get instructions on how to disable these.

WP Engine does not support FXP (File eXchange Protocol) due to its dependency upon FTP (File Transfer Protocol), which is an insecure method of transferring files. WP Engine only supports SFTP (Secure File Transfer Protocol) due to its improved security features.

NEXT STEP: Troubleshooting with the WP Engine error logs

【本文地址】

公司简介

联系我们