[TOC]

0x00 前言简述

描述: 在运维过程中会将服务器上数据文件备份在共享磁盘或者FTP服务器中，此处由于作者环境是在Windows系统上，且在业务上需要同步文件到FTP服务器中，遂有了此文，帮助各位看友了解，如何在Windows上使用Powershell脚本将数据备份文件自动上传的FTP服务器上?

在下述实践中，我们可以使用三种方式进行数据文件上传到FTP服务器中。

  • 方式1.使用Powershell与Windows原生ftp客户端工具(仅仅支持主动模式)进行文件备份.
  • 方式2.使用Powershell中.NET的内置的FTP操作类 System.Net.FtpWebRequest 连接ftp服务器并进行备份文件上传.
  • 方式3.使用Powershell的PSFTP模块包连接ftp服务器并进行备份文件上传。

项目地址（欢迎大家 star ，蟹蟹٩(‘ω’)و支持 ）: https://github.com/WeiyiGeek/SecOpsDev/

下述实验室需要部署FTP服务器，若不了解的童鞋，可参考博主的FTP入门扫盲篇《FTP远程文件传输服务安装与配置》，文章地址: https://blog.weiyigeek.top/2019/10-4-74.html

或者参考此《使用Kubernetes容器快速部署常用服务》( https://blog.weiyigeek.top/2022/2-25-668.html )文章快速使用 kubernetes 安装 vsftpd 服务，搭建ftp测试环境。

废话不多说，实践为王！

首发链接: https://mp.weixin.qq.com/s/YuaqncfbOsC3-wjCdikfBw

0x01 实践演示

实践1.使用Powershell与Windows原生ftp客户端工具(仅仅支持主动模式)进行文件备份.

代码示例:

WeiyiGeek.使用Powershell与Windows原生ftp客户端备份图

WeiyiGeek.使用Powershell与Windows原生ftp客户端备份图

温馨提示: 为了保障脚本中FTP密码的安全性，我将脚本中高敏感的账号密码进行编码存储（只能防君子，不能防小人😃）。

1
2
3
4
5
6
7
8
9
# 编码
$bytes = [System.Text.Encoding]::Unicode.GetBytes("weiyigeek")
$str = [System.Convert]::ToBase64String($bytes)
echo $str

# 解码
$str = "VwBlAGkAeQBpAEcAZQBlAGsAZQByAA=="
[System.Text.Encoding]::ASCII.GetString([System.Convert]::FromBase64String($str))
[System.Text.Encoding]::ASCII.GetString([System.Convert]::FromBase64String($str)) | Out-File -Encoding "ASCII" plaintext.html

温馨提示: 获取上述示例代码或者脚本地址失效，请在【全栈工程师修炼指南】公众号回复 PowerShell-FTP 或者 10000 获取最新PowerShell的FTP同步脚本地址。
全栈工程师修炼指南: https://weiyigeek.top/wechat.html?key=10000
注意提示: 在中文Windows下执行脚本默认为GBK，若是乱码请转为GBK或者其他编码模式。


实践2.使用Powershell中.NET的内置的FTP操作类 System.Net.FtpWebRequest 连接ftp服务器并进行备份文件上传.

描述: 在实践1中的方式由于windows自带的ftp客户端只支持（主动模式），对于FTP被动模式是没有办法的，此时我们可以采用如下方式进行被动模式下上传文件到FTP空间之中。

代码示例:

WeiyiGeek.在PS中使用.NET的内置的FTP操作类图

WeiyiGeek.在PS中使用.NET的内置的FTP操作类图

执行结果:

WeiyiGeek.上传到FTP服务器中的备份文件图

WeiyiGeek.上传到FTP服务器中的备份文件图


温馨提示: 获取上述示例代码或者脚本地址失效，请在【全栈工程师修炼指南】公众号回复 PowerShell-FTP 或者 10000 获取最新PowerShell的FTP同步脚本地址。
全栈工程师修炼指南: https://weiyigeek.top/wechat.html?key=10000
注意提示: 在中文Windows下执行脚本默认为GBK，若是乱码请转为GBK或者其他编码模式。


为了实现脚本的自动执行，我们可以将其配置到计算机任务计划中，进行定时执行，操作流程如下：

步骤 01.在开始->运行 命令行执行 taskschd.msc 命令 或者 打开任务计划程序。

步骤 02.新建任务计划，创建基本任务，设置触发实践以及触发操作，如下图所示

WeiyiGeek.Windows下的定时任务图

WeiyiGeek.Windows下的定时任务图


实践3.使用Powershell的PSFTP模块包连接ftp服务器并进行备份文件上传。

描述: 通过上面实践我们了解到PowerShell本身并没了内置对FTP的支持，但是.net里面内置了FTP操作的类，但是确实自己来组合封装几个FTP操作类是不是比较费时。

此时我只想偷懒，我去PowerShell Gallery里面搜寻一番后（ https://www.powershellgallery.com ），发现已经有人帮我造好轮子了即 PSFTP 模块包，既然这样那就不客气了，拿来开箱即用！

在使用前我们需要安装 PSFTP 模块包，模块当前版本为 1.7.1.1，其作用是管理FTP帐户的功能。
模块地址: https://www.powershellgallery.com/packages/PSFTP/1.7.1.1


安装：
官网提供了三种安装方式，即在线命令安装、Azure云安装以及手动下载安装。

1
2
3
4
5
6
7
8
9
10
11
12
# 在线: 复制并粘贴以下命令以使用PowerShellGet更多信息安装此程序包。（可能受到环境影响，推荐）
PS> Install-Module -Name PSFTP	
  # 需要使用 NuGet 提供程序来继续操作
  # PowerShellGet 需要使用 NuGet 提供程序“2.8.5.201”或更高版本来与基于 NuGet 的存储库交互。必须在“C:\Program
  # Files\PackageManagement\ProviderAssemblies”或“C:\Users\WeiyiGeek\AppData\Local\PackageManagement\ProviderAssemblies”
  # 中提供 NuGet 提供程序。也可以通过运行 'Install-PackageProvider -Name NuGet -MinimumVersion 2.8.5.201 -Force' 安装 NuGet
  #  提供程序。是否要让 PowerShellGet 立即安装并导入 NuGet 提供程序?
    [Y] 是(Y)  [N] 否(N)  [S] 暂停(S)  [?] 帮助 (默认值为“Y”): Y

# 手动: 手动将.nupkg文件下载到系统的默认下载位置。（需要配置较多）
# https://psg-prod-eastus.azureedge.net/packages/psftp.1.7.1.1.nupkg
PS> Install-Package  psftp.1.7.1.1.nupkg


验证

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
# 安装PSFTP包之后我们使用如下命令查看是否已经安装成功
PS> Get-Module PSFTP -ListAvailable
  # 目录: C:\Program Files\WindowsPowerShell\Modules
  
  # ModuleType Version    Name                                ExportedCommands
  # ---------- -------    ----                                ----------------
  # Manifest   1.7.1.1    PSFTP                               {Add-FTPItem, Get-FTPChildItem, Get-FTPConnection, Get-FTPItem...}

# 查看PSFTP工具里面都支持那些操作
PS> Get-Command -FullyQualifiedModule PSFTP
  CommandType     Name                                               Version    Source
  -----------     ----                                               -------    ------
  Alias           Move-FTPItem                                       1.7.1.1    PSFTP
  Alias           Receive-FTPItem                                    1.7.1.1    PSFTP
  Alias           Send-FTPItem                                       1.7.1.1    PSFTP
  Function        Add-FTPItem                                        1.7.1.1    PSFTP
  Function        Get-FTPChildItem                                   1.7.1.1    PSFTP
  Function        Get-FTPConnection                                  1.7.1.1    PSFTP
  Function        Get-FTPItem                                        1.7.1.1    PSFTP
  Function        Get-FTPItemSize                                    1.7.1.1    PSFTP
  Function        New-FTPItem                                        1.7.1.1    PSFTP
  Function        Remove-FTPItem                                     1.7.1.1    PSFTP
  Function        Rename-FTPItem                                     1.7.1.1    PSFTP
  Function        Set-FTPConnection                                  1.7.1.1    PSFTP
  Function        Test-FTPItem                                       1.7.1.1    PSFTP

# 查看帮助命令
PS> Get-Help Set-FTPConnection -Examples


命令行实践
描述: 此处我按照文章首部的地址，进行安装了ftp测试环境，其FTP链接环境信息如下：

IP: 10.20.176.215
Port: 30021
User: weiyigeek
Pass: password

首先，利用Windows中原生的ftp客户端工具链接测试（PS: 如果是使用Linux登录就不存在问题）：

1
2
3
4
5
6
7
8
9
10
11
12
PS L:\WeiyiGeek> ftp
ftp> open 10.20.176.215 30021
连接到 10.20.176.215。
220 (vsFTPd 3.0.2)
200 Always in UTF8 mode.
用户(10.20.176.215:(none)): weiyigeek
331 Please specify the password.
密码:
230 Login successful.
ftp> dir
500 Illegal PORT command.
425 Use PORT or PASV first. # 可看到不支持被动模式。

然后，我们手动使用PSFTP模块进行被动链接测试：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# 配置 PowerShell 执行策略导入安装的PSFTP模块
Set-executionpolicy remotesigned
Import-Module PSFTP

# ftp 认证票据生成
$FTPConnect = "ftp://10.20.176.215:30021"  # FTP 服务器链接字符串
$FTPUser = "weiyigeek" 
$FTPPass = ConvertTo-SecureString -String "password" -AsPlainText -Force
$FTPCre = New-Object -TypeName System.Management.Automation.PSCredential -ArgumentList $FTPUser, $FTPPass

# 连接到 ftp 服务器链接 (被动链接)
Set-FTPConnection -Credentials $FTPCre -Server $FTPConnect -UsePassive
  # 执行结果：
    # ContentLength           : -1
    # Headers                 : {}
    # SupportsHeaders         : True
    # ResponseUri             : ftp://10.20.176.215:30021/
    # StatusCode              : ClosingData
    # StatusDescription       : 226 Directory send OK.
    # LastModified            : 0001/1/1 0:00:00
    # BannerMessage           : 220 (vsFTPd 3.0.2)
    # WelcomeMessage          : 230 Login successful.
    # ExitMessage             : 221 Goodbye.
    # IsFromCache             : False
    # IsMutuallyAuthenticated : False
    # ContentType             :

最后，我们使用PSFTP进行文件管理:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# 1.添加/上传文件 - Add-FTPItem (Send-FTPItem)
Send-FTPItem -LocalPath .\console.log
Send-FTPItem -LocalPath .\weiyigeek.txt -Overwrite

# 2.新建目录 - New-FTPItem
New-FTPItem -Name weiyigeek
# - 指定目录创建子目录
New-FTPItem -Name subdir -Path $FTPConnect/weiyigeek 
  # 257 "/weiyigeek/subdir" created

# 3.获取目录下面的文件、子目录 - Get-FTPChildItem
Get-FTPChildItem
  #     Parent:ftp://10.20.176.215:30021
  # Dir Right     Ln  User   Group  Size   ModifiedDate        Name
  # --- -----     --  ----   -----  ----   ------------        ----
  # d   rwx------ 2   ftp    ftp           2023/3/7 11:17:00   weiygeek
  # -   rw------- 1   ftp    ftp    18KB   2023/3/7 11:11:00   console.log
  # -   rw------- 1   ftp    ftp    2KB    2023/3/7 11:12:00   ls.txt
Get-FTPChildItem -Path subdir  # 指定目录
Get-FTPChildItem -Recurs -Depth 1     # 递归返回所有信息

# 4.下载文件 - Get-FTPItem（Receive-FTPItem）
# - 下载image.png到当前目录
Get-FTPItem weiyigeek.png
# - 下载image.png到指定目录
Get-FTPItem weiyigeek.png -LocalPath D:\download
# - 下载image.png到指定目录，如果指定目录不存在自动创建
Get-FTPItem weiyigeek.png -LocalPath D:\download\1\2\3\4\5 -RecreateFolders

# 5.获取文件大小 - Get-FTPItemSize
(Get-FTPItemSize console.log)/1000
18.781

# 6.删除文件 - Remove-FTPItem
Remove-FTPItem .\ls.txt
  # ->Remove File: ftp://10.20.176.215:30021/.\ls.txt
  # 250 Delete operation successful.

# 7.重命名文件或者目录 - Rename-FTPItem（Move-FTPItem）
Rename-FTPItem -Path .\console.log -NewName weiyigeek.top.log
  # 250 Rename successful.

是不是，感觉比实践2中.net实现方便多了，所以用起来是真的舒服，实际上它是将.net中的方法进行了封装。


项目实践:

WeiyiGeek.PSFTP模块实践自动上传备份文件代码图

WeiyiGeek.PSFTP模块实践自动上传备份文件代码图

执行结果:

1
2
3
4
5
6
7
8
9
10
11
12
PS D:\Tools> .\DB-Backup-To-FTP-Use-PSFTP-Package.ps1
[03/08/2023 09:09:08] 当前数据库备份文件 qchatgpt.legacy.log ，写入 ./upload.txt 文件中!
[03/08/2023 09:09:08] 当前数据库备份文件 qchatgpt.legacy.log , 上次数据库备份文件 logs 名称, 上传标识 1 .
230 Login successful.

   Parent:ftp://10.20.176.215:30021/weiyigeek/qchatgpt.legacy.log

Dir Right     Ln  User   Group  Size   ModifiedDate        Name
--- -----     --  ----   -----  ----   ------------        ----
-   rw------- 1   ftp    ftp    34KB   2023/3/8 1:09:00    qchatgpt.legacy.log
[03/08/2023 09:09:08] Upload Status:
Upload File /weiyigeek/qchatgpt.legacy.log successful!

WeiyiGeek.使用PSFTP模块实践图

WeiyiGeek.使用PSFTP模块实践图


温馨提示: 获取上述示例代码或者脚本地址失效，请在【全栈工程师修炼指南】公众号回复 PowerShell-FTP 或者 10000 获取最新PowerShell的FTP同步脚本地址。
全栈工程师修炼指南: https://weiyigeek.top/wechat.html?key=10000
注意提示: 在中文Windows下执行脚本默认为GBK，若是乱码请转为GBK或者其他编码模式。


本文介绍了PowerShell操作FTP的方法，以及使用.net 提供的类来访问FTP。

好了，本章到此介绍，感兴趣的朋友请继续研究吧!