台湾入籍一百四十年，奸民十一起；浮动好乱，其土性然也。生齿日繁，所在多游手，非械斗则为盗。道光三年，赵文恪督闽，患之，慎选守令，以福州府方传穟署台守，一时台湾道孔昭虔、台湾县李慎彝、凤山县杜绍祁、嘉义县王衍庆、淡水厅吴性诚、噶玛兰厅吕志恒皆有声。四年五月，凤山县打鼓山鸣园竹生花，七月逢闰，民间以为昔林爽文反，有此兆，讹言间起。台防同知缺，杜绍祁代之；署凤山县者，刘功杰也；颇锐意捕盗。未几而许尚之事起。
许尚者，凤山广安庄人，业卖槟榔，素结诸无赖，群盗悦之。为乡保所告，惧捕，遂与所善蔡双弼、张仔来、商乌紫、王曾、杨良斌、沈古老、徐红柑、林溪及番人潘老通谋反。其党甚众，期以十月十一日集议，先攻下淡水县丞署，次攻埤头，遂及郡城。苦无赀，先肆劫掠，时反谋未露也。传穟闻盗，檄县急捕。尚将起，其庄人刘黄中微闻其谋，留诸家，劝之不使尚出。功杰捕尚及良斌不得，焚其居，迹至黄中家，十三日遂以尚献，械系驰送于郡。
传穟亲讯之，得某反状，言于镇道曰：「许尚之党俱在，事破必速乱。埤头无城，不可守也，刘令初仕，其参将又懦，宜增兵防。且台地匪民所在，啸聚甚易。曩者南路有事则北路起应，北路有事则南路骚动，郡民常苦为所掣；今宜及未起，速备北路，俾我得专力于南。」镇道皆然之。乃密饬嘉彰淡水为备。时苦积潦，郡城、嘉义城垣皆圯，急缮治之。使绍祁偕县丞丁嘉植、都司翁朝龙以郡兵二百协守埤头。埤头者，凤山县治也；旧县毁于林爽文，移治埤头，仅树竹围，又毁于蔡牵，故虑之。至则民间已纷言贼起，争避郡城，然莫知贼所在。营县日出清庄，捕贼十余人，最后得其军师林溪。
许尚之被获也，其党将散，杨良斌不可；众乃推良斌为首，聚议黄梨山中。良斌制刀、杖、旗帜，使潘老通借炮于其舅番通事潘巴能，以林溪为军师，王曾为都督领红旗，李川、郑荣春为正副先锋领乌旗，蔡双弼以下皆为头目，分招贼众，期二十四夜攻埤头，戕官据地，即乘胜攻郡城。使徐红柑自台湾、沈古老自嘉义，各招其党并起，又使吴赐潜入郡城，结匪民内应。约既定，二十一日林溪至埤头市五色绸制旗。溪，故县中皂役侦贼者也，阴为贼主谋，官所往贼先知之，故其谋甚密。溪市得绸，使人持往，已将饭而后行，其母诘知出首，故获之，讯未即服。
良斌见获溪，不待众集，二十二夜遂以贼数百人分西北两路攻埤头，杀苦苓门汛兵，自竹围隙处以入。埤头先有备，绍祁、功杰守县署，朝龙、嘉植守仓。贼先至仓，朝龙挥兵击之，伤毙二贼，贼燃大炮不震，遂败走。其县前贼已砍栅门将入，亦为乡勇击退。参将某闻贼，拥兵火药库不出，翌日语朝龙曰：「贼虽败，必且大至，埤头仓署皆不可守，火药库有土垣，四面阻水，昔蔡牵攻不能破，可速据此。」朝龙惑之，遂移兵入，文官相率随入。民大惶惧奔逃，奸人乘间抢掠，塘报兵又为贼杀，道路遂梗。
二十三夜，郡中闻警，乃议昭虔、慎彝以城守，左营及安平水师兵守郡。传穟与署台镇赵裕、福中营游击杨俊督师援凤山。许尚犹在府监，斩之而后行。时郡中讹言四起，人心震骇，绅士韩高扬、黄化鲤等入见传穟请方略，传穟曰：「凤山虽一隅，距郡城百里，贼朝发可夕至也，恐有奸宄应之，宜固根本。今郡城垣坏，漏夜筑之，两日可竣。城内外街市，多立木栅，君等率丁壮随李令日夜亲巡，城上分布兵勇；安平副将率水师六百人驻西城外蝼蛄石，以卫商行为犄角；城内设劲兵三百人，环甲露宿，足为策应。各衙门及绅士家皆募乡勇以收游民，无使助贼。惟大兵南下，贼必溃走，当遏之勿使越入郡境。已饬台湾、嘉义营县分屯兵勇，扼其要隘，且令各庄耆简壮丁相为守援；土贼不得往应，则吾事济矣！」或请闭郡八门，曰：「不可！南路难民避贼者日数千至，不能无纳；且毋使北路谣传郡城被围，启奸人心也。道试甫毕，各学官俱在，率兵役守门，稽出入而已。」众悦，守备遂严。
二十四日，镇将兵起；传穟部署毕。二十五日，亦以兵二百、乡勇二百继之，经何公店，南北适中地也，民居颇稠，留兵勇二百人，使训导谢代埙驻之，以扼其冲，道乃通。二十六日至埤头，撤功杰，使绍祁回任，署镇亦撤其参将，以朝龙代。传穟乃督民夫增补竹围，绕围浚深沟，中插竹签。招抚逃民，谕各乡守庄捕贼。其先受贼约，能自首者免罪。绍祁更募乡勇八百名，以四百人守埤头，四百人偕官兵捕贼。县役中有通贼者，不敢动，而颇自危，绍祁大度示之，不复穷究，反侧遂安。贼自埤头走黄梨山，竖旗招众。镇将初至，不测贼众寡，又以负险，颇患之，未遽击。既而各路兵屯乡庄受府县约束，阻守要隘甚密，所在匪民观望待起者不下数千，贼不能通，至是竟无敢应者。嘉义贼将自内山潜至，扼于王李二令，皆散走。吴赐至郡城，为慎彝彝诛。新授台湾镇蔡万龄亦至。良斌见众不集，大惧，其党乃离。兵勇进攻之，遂溃。传穟、绍祁亟悬重赏捕贼，王曾、李川、蔡双弼以下全获，伏诛。良斌驾小舟入海，逃至彰化，县令李振青获之，送郡，南路遂平。
是役也，自许尚起及竣事，仅一月，不烦内兵，不使贼蹂躏闾阎。南路办贼，北路宴如。凡用饷银数万，皆筹款补给，不费帑金者，郡县得人之效也。奏入，上大嘉之，曰：「方传穟总司筹办，悉协机宜，特赏花翎；镇道以下，各从优议叙。」明年，乃建凤山县城于旧治。